警翼移动执法电子证据管理软件对外接口说明指导书

®警辑

■■"智,造中国执法新形・

移动执法电子证据管理软件对外接口

说明书

深圳警翼智能科技股份

地址：深圳市南山区粤海街道滨海大道深圳市软件产业基地5栋E座1102

电话：（+86）

传真：（+86）

目录

一、概述5

二、组织机构列表接口6

2.1功效说明6

2.2处理过程6

2.3接口协议6

2.4返回JSON文档说明

2.4.1返回header参数说明7

2.4.2返回body参数说明7

2.5备注

三、统计仪列表接口9

3.1功效说明9

3.2处理过程9

3.3接口协议9

3.4返回JSON文档说明9

3.4.1返回header参数说明10

34.2返网body参数说明10

3.5备注

四、视频获取接口12

4.1功效说明12

4.2处理过程12

4.3接口协议12

4.4返回JSON文档说明13

4.4.1返回header参数说明13

4.4.2返回body参数说明13

4.5备注

五、视频、图片、音频播放接口16

5.1功效说明16

5.2处理过程16

5.3接口协议16

5.4返回视频、图片、音频播放说明16

概述

1、目标

方便其它系统能够方便地对接木系统，能够方便地得到需要视频文件播放地址，能够调用本系统播放页面。

2、术语

执法统计仪：又称警用执法统计仪或现场执法统计仪，是一款集数码摄像、数码摄影、对讲送话器功效于一

身，能够对执法过程中进行动态、静态现场情况数字化统计便携式设备。以下简称统计仪。

警翼DZZJ移动执法电子证据管理软件：由深圳警翼软件技术开发，用于对基层公安机关聚集多媒体执法资

料查询和管理。本软件全方面支持警翼采集工作站及警翼现场执法统计仪，可实现模块化组网模式，将基层用户

和管理单位连成整体，方便执法资料跨区域跨等级查询调用、电子证据实现全局统一管理，更有利于保护民警权

益、规范民警执法。以下简称DZZJ管理软件。

3、约定

为使得描述能够愈加正确，文档中均给出了json示例，示例中所包含值并无特殊含义。特此说明。

二、组织机构列表接口

2.1功效说明

理供给第三方管理平台查看、调用DZZJ管理软件组织机构架构。

2.2处理过程

1、对传入接口参数进行解析，返【可对应页组织机构架构信息；

2、本接口默认返回第一页统计仪信息；

3、每页默认返回50条组织机构信息。当返回组织机构信息不足50条时，表示已查询到目前组织机构信息

最终一页。

2.3接口协议

URLhttp://[ip]:[port]/?_a=getunit&pagc=l

http请求类型GET/POST

输出格式Json(application/json;charset=utf-8)

1、参数说明

page查询第儿页数据［每页50条）

2.4返回JSON文档说明

1、输入请求示例

http://[ip]：[port]/?a=getunit&page=l

2、返回示例

“header”:{

〃4,〃〃〃

state:success,

count:11

“body”:Array[11]

}

2.4.1返回header参数说明

参数项数据类型数据长度是否可空说明

返问请求状态,success表示请求成功，请求成功时，

statevarchar255否

在body中显示请求主体；

countint11否返回请求主体数量；

2.4.2返回body参数说明

参数项数据类型数据长度是否可空说明

idint11否组织机构id

unit_novarchar255是组织机构编号

unit_namevarchar255是组织机构名称

parentidint11否上级组织机构id

orderbyint2是组织机构排序

3、返回主体:

〃・1〃〃c〃

id:2,

〃..〃〃〃

unit_no:,

“unitname":〃XX区公安局〃,

parentid:1,

orderby:1

)

三、统计仪列表接口

3.1功效说明

遑供给第三方管理平台查看、调用DZZJ管理软件统计仪信息。

3.2处理过程

1、对传入接口参数进行解析，返【可对应页统计仪信息；

2、本接口默认返回第一页统计仪信息；

3、每页默认返回50条组织机构信息。当返回组织机构信息不足50条时，表示已查询到目前组织机构信息

最终一页。

3.3接口协议

URLhttp://[ip]:[port]/?_a=gGtdevice&pago=l

http请求类型GET/POST

输出格式Json(application/json;charset=utf-8)

1、参数说明

page查询第儿页数据［每页50条）

3.4返回JSON文档说明

1、输入请求示例

http://[ip]：[port]/?a=getdevice&page=1

2、返回示例

“header”:{

〃4,〃〃〃

state:success,

“count”:50

"body":Array[50]

}

3.4.1返回header参数说明

参数项数据类型数据长度是否可空说明

返问请求状态,success表示请求成功，请求成功时，

statevarchar255否

在body中显示请求主体；

countint11否返回请求主体数量；

3.4.2返回body参数说明

参数项数据类型数据长度是否可空说明

idint11否统计仪id

hostnamevarchar255是统计仪持有些人姓名

hostcodevarchar255是统计仪持有些人编号

hostbodyvarchar255是统计仪编号

unit_novarchar255是组织机构编号

statevarchar2否0-正常；1-报障,2-报废;

3、返回主体:

〃id〃：〃35

〃hos二name”:〃宋江〃，

〃hos二code":"100099〃，

“hosubody〃：〃1671518〃,

〃unijno〃：“1001〃，

stase〃:〃八0

}

U!视频获取接口

4.1功效说明

理供给第三方管理平台查看、调用DZZJ管理软件视频信息。

4.2处理过程

1、对传入接口参数进行解析并校验，若参数不全或无效，则直接返回错误码和错误信息；

2、经过检验后，显示对应页视域数据信息；

3、本接口默认返回第一页视频信息；

4、每页默认返回50条组织机构信息。当返I可组织机构信息不足50条时，表示已查询到目前组织机构信息

最终一页。

4.3接口协议

URLhttp://[ip]:[port]/?_a=getmedia&page=l&begin_time=日期&police_id=id&org_code=code

http请求类型GET/POST

输出格式Json(application/json;charsct=utf-8)

1、参数说明

page查询第几页数据［每页50条）

begin_time上传时间（时间格式为YYYY-mm-dd）

policeid警员编号

orgcode组织机构编号

4.4返回JSON文档说明

1、输入请求示例

http://[ip]：[port]/?_a=getmedia&page=l&begintime=-10-24&po1ice_id=1OOOOO&org_code=

2、返回示例

(

“header”:{

state:success,

count:7

),

“body":Array[7]

(

4.4.1返回header参数说明

参数项数据类型数据长度是否可空说明

返回请求状态,success表示请求成功，请求成功时，

statevarchar255否在body中显示请求主体；fail表示请求失败，并返回

失败信息；

coun:int11否返回请求主体数量；

4.4.2返回body参数说明

参数项数据类型数据长度是否可空说明

data_idint11否视频id

capture_datevarchar255是创建时间

device_novarchar255是统计仪编号

creationdatetimestamp0是上传时间

medianamevarchar255否文件名：机身编号@生成日期

file_namevarchar255是文件别名

police_novarchar255是统计仪持有些人编号

org_novarchar255是组织机构编号

orgnamevarchar255是组织机构名称

file_typevarchar255是文件类型

serverurlvarchar255是文件上传服务器地址

playpositionvarchar255是播放相对位置

thumbvarchar255是缩略图

file_lengthvarchar255是文件长度(Byte)

file_durationint11是视频播放时间长度(ms)

media_desclongtcxt0是备注

upload_station_ipvarchar255否创建工作站ip

uploadstationvarchar255是创建工作站

thumburl_defvarchar255是默认媒体缩略图

thumburlvarchar255是缩略图地址

playurlvarchar255是播放地址

3、返回主体:

〃data_id〃：〃548〃，

〃capture_date〃：”-10-2413:53:06〃，

〃device_no〃：“1671421”,

〃creation_date〃："-10-2414:53:25〃，

“medianame":"1671421@00〃，

〃fi1e_name/z:〃张飞@00〃，

〃police_no〃：T00000〃，

〃〃〃〃

orgno:,

〃org_namc〃：〃XX区公安局〃，

//file_type/z:〃MP4",

serverurl:rIrServer,

/zplaypositionz/:*media/l024/MP4/”,