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

17移动执法电子证据管理软件对外接口说 明 书深圳警翼智能科技股份有限公司地址：深圳市南山区粤海街道滨海大道深圳市软件产业基地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处理过程 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移动执法电子证据管理软件：由深圳警翼软件技术有限公司开发，用于对基层公安机关汇集的多媒体执法资料的查询与管理本软件全面支持警翼采集工作站及警翼现场执法记录仪，可实现模块化组网模式，将基层用户与管理单位连成整体，方便执法资料跨区域跨级别查询调用、电子证据实现全局统一管理，更有利于保护民警权益、规范民警执法以下简称DZZJ管理软件3、约定为使得描述能够更加准确，文档中均给出了json示例，示例中所涉及的值并无特殊含义特此说明二、组织机构列表接口2.1功能说明提供给第三方管理平台查看、调用DZZJ管理软件的组织机构架构2.2处理过程1、对传入接口参数进行解析，返回对应页的组织机构架构信息；2、本接口默认返回第一页记录仪信息；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":Array[11]}2.4.1返回header参数说明参数项数据类型数据长度是否可空说明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"}三、记录仪列表接口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://[ip]:[port]/?_a=getdevice&page=12、返回示例{   "header":{      "state":"success",      "count":50   },   "body":Array[50]}3.4.1返回header参数说明参数项数据类型数据长度是否可空说明statevarchar255否返回请求状态,success表示请求成功，请求成功时，在body中显示请求主体；countint11否返回请求主体的数量；3.4.2返回body参数说明参数项数据类型数据长度是否可空说明idint11否记录仪idhostnamevarchar255是记录仪持有人姓名hostcodevarchar255是记录仪持有人编号hostbodyvarchar255是记录仪编号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条时，表示已查询到当前组织机构信息的最后一页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_time=2016-10-24&police_id=&org_code=20012、返回示例{    "header":{        "state":"success",        "count":7    },    "body":Array[7]}4.4.1返回header参数说明参数项数据类型数据长度是否可空说明statevarchar255否返回请求状态,success表示请求成功，请求成功时，在body中显示请求主体；fail表示请求失败，并返回失败信息；countint11否返回请求主体的数量；4.4.2返回body参数说明参数项数据类型数据长度是否可空说明data_idint11否视频idcapture_datevarchar255是创建时间device_novarchar255是记录仪编号creation_datetimestamp0是上传时间media_namevarchar255否文件名: 机身编号@生成日期file_namevarchar255是文件别名police_novarchar255是记录仪持有人编号org_novarchar255是组织机构编号org_namevarchar255是组织机构名称file_typevarchar255是文件类型serverurlvarchar255是文件上传的服务器地址playpositionvarchar255是播放相对位置thumbvarchar255是缩略图file_lengthvarchar255是文件长度(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: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_de。