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

1、移动执法电子证据管理软件对外接口说 明 书深圳警翼智能科技股份有限公司地址：深圳市南山区粤海街道滨海大道深圳市软件产业基地5栋E座1102电话：(+86) 0755-传真：(+86) 0755-目录一、概述3二、组织机构列表接口42.1功能说明42.2处理过程42.3接口协议42.4返回JSON文档说明42.4.1返回header参数说明52.4.2返回body参数说明52.5备注5三、记录仪列表接口63.1功能说明63.2处理过程63.3接口协议63.4返回JSON文档说明63.4.1返回header参数说明73.4.2返回body参数说明73.5备注7四、视频的获取接口84.1功能说明84

2、.2处理过程84.3接口协议84.4返回JSON文档说明84.4.1返回header参数说明84.4.2返回body参数说明94.5备注10五、视频、图片、音频的播放接口115.1功能说明115.2处理过程115.3接口协议115.4返回视频、图片、音频的播放说明11一、概述1、目的方便其它系统能够方便地对接本系统，能够方便地得到需要视频文件的播放地址，能够调用本系统的播放页面。2、术语执法记录仪：又称警用执法记录仪或现场执法记录仪，是一款集数码摄像、数码照相、对讲送话器功能于一身，能够对执法过程中进行动态、静态的现场情况数字化记录的便携式设备。以下简称记录仪。警翼DZZJ移动执法电子证据管理

3、软件：由深圳警翼软件技术有限公司开发，用于对基层公安机关汇集的多媒体执法资料的查询与管理。本软件全面支持警翼采集工作站及警翼现场执法记录仪，可实现模块化组网模式，将基层用户与管理单位连成整体，方便执法资料跨区域跨级别查询调用、电子证据实现全局统一管理，更有利于保护民警权益、规范民警执法。以下简称DZZJ管理软件。3、约定为使得描述能够更加准确，文档中均给出了json示例，示例中所涉及的值并无特殊含义。特此说明。二、组织机构列表接口2.1功能说明提供给第三方管理平台查看、调用DZZJ管理软件的组织机构架构。2.2处理过程1、对传入接口参数进行解析，返回对应页的组织机构架构信息；2、本接口默认返回

4、第一页记录仪信息；3、每页默认返回50条组织机构信息。当返回组织机构信息不足50条时，表示已查询到当前组织机构信息的最后一页。2.3接口协议URLhttp:/ip:port/?_a=getunit&page=1http请求类型GET/POST输出格式Json (application/json;charset=utf-8)1、 参数说明page查询第几页数据（每页50条）2.4返回JSON文档说明1、输入请求示例http:/ip:port/?_a=getunit&page=12、返回示例header:state:success,count:11,body:Array112.4.1返回heade

5、r参数说明参数项数据类型数据长度是否可空说明statevarchar255否返回请求状态,success表示请求成功，请求成功时，在body中显示请求主体；countint11否返回请求主体的数量；2.4.2返回body参数说明参数项数据类型数据长度是否可空说明idint11否组织机构idunit_novarchar255是组织机构编号unit_namevarchar255是组织机构名称parentidint11否上级组织机构idorderbyint2是组织机构排序3、返回主体：id:2,unit_no:2001,unit_name:XX区公安局,parentid:1,orderby:1三、记

6、录仪列表接口3.1功能说明提供给第三方管理平台查看、调用DZZJ管理软件的记录仪信息。3.2处理过程1、对传入接口参数进行解析，返回对应页的记录仪信息；2、本接口默认返回第一页记录仪信息；3、每页默认返回50条组织机构信息。当返回组织机构信息不足50条时，表示已查询到当前组织机构信息的最后一页。3.3接口协议URLhttp:/ip:port/?_a=getdevice&page=1http请求类型GET/POST输出格式Json (application/json;charset=utf-8)1、参数说明page查询第几页数据（每页50条）3.4返回JSON文档说明1、输入请求示例http:/

7、ip:port/?_a=getdevice&page=12、返回示例header:state:success,count:50,body:Array503.4.1返回header参数说明参数项数据类型数据长度是否可空说明statevarchar255否返回请求状态,success表示请求成功，请求成功时，在body中显示请求主体；countint11否返回请求主体的数量；3.4.2返回body参数说明参数项数据类型数据长度是否可空说明idint11否记录仪idhostnamevarchar255是记录仪持有人姓名hostcodevarchar255是记录仪持有人编号hostbodyvarcha

8、r255是记录仪编号unit_novarchar255是组织机构编号statevarchar2否0-正常；1-报障，2-报废；3、返回主体：id:35,hostname:宋江,hostcode:,hostbody:,unit_no:1001,state:0四、视频的获取接口4.1功能说明提供给第三方管理平台查看、调用DZZJ管理软件的视频信息。4.2处理过程1、 对传入接口参数进行解析并校验，若参数不全或无效，则直接返回错误码和错误信息；2、 通过检验后，显示对应页的视频数据信息；3、 本接口默认返回第一页视频信息；4、每页默认返回50条组织机构信息。当返回组织机构信息不足50条时，表示已查询

9、到当前组织机构信息的最后一页。4.3接口协议URLhttp:/ip:port/?_a=getmedia&page=1&begin_time=日期&police_id=id&org_code=codehttp请求类型GET/POST输出格式Json (application/json;charset=utf-8)1、参数说明page查询第几页数据（每页50条）begin_time上传时间（时间格式为YYYY-mm-dd）police_id警员编号org_code组织机构编号4.4返回JSON文档说明1、输入请求示例http:/ip:port/?_a=getmedia&page=1&begin_t

10、ime=2016-10-24&police_id=&org_code=20012、返回示例header:state:success,count:7,body:Array74.4.1返回header参数说明参数项数据类型数据长度是否可空说明statevarchar255否返回请求状态,success表示请求成功，请求成功时，在body中显示请求主体；fail表示请求失败，并返回失败信息；countint11否返回请求主体的数量；4.4.2返回body参数说明参数项数据类型数据长度是否可空说明data_idint11否视频idcapture_datevarchar255是创建时间device_no

11、varchar255是记录仪编号creation_datetimestamp0是上传时间media_namevarchar255否文件名: 机身编号生成日期file_namevarchar255是文件别名police_novarchar255是记录仪持有人编号org_novarchar255是组织机构编号org_namevarchar255是组织机构名称file_typevarchar255是文件类型serverurlvarchar255是文件上传的服务器地址playpositionvarchar255是播放相对位置thumbvarchar255是缩略图file_lengthvarchar25

12、5是文件长度(Byte)file_durationint11是视频的播放时间长度(ms)media_desclongtext0是备注upload_station_ipvarchar255否创建工作站ipupload_stationvarchar255是创建工作站thumburl_defvarchar255是默认媒体缩略图thumburlvarchar255是缩略图地址playurlvarchar255是播放地址3、返回主体：data_id:548,capture_date:2016-10-24 13:53:06,device_no:,creation_date:2016-10-24 14:53

13、:25,media_name:,file_name:张飞,police_no:,org_no:2001,org_name:XX区公安局,file_type:MP4,serverurl:FTPServer,playposition:media/MP4/.MP4,thumb:media/MP4/.THM.JPG,file_length:263.25,file_duration:,media_desc:afafaafa,upload_station_ip:13,upload_station:WS06S,thumburl_def:,thumburl:http:/ip/media/MP4/.THM.JPG,playurl:http:/ip/media/MP4/.MP4五、视频、图片、音频的播放接口5.1功能说明提供给第三方管理平台使用DZZJ管理软件的视频、图片、音频的播放功能。使用播放功能应下载DZZJ管理软件的播放器。5.2处理过程1、