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

1、警翼警智造 中国执法新形象移动执法电子证据管理软件对外接口说明书深圳警翼智能科技股份有限公司地址：深圳市南山区粤海街道滨海大道深圳市软件产业基地5栋E座1102电话：(+86)1传真：(+86)1目录56 TOC o 1-5 h z HYPERLINK l bookmark8 o Current Document 功能说明 6 HYPERLINK l bookmark10 o Current Document 处理过程 6 HYPERLINK l bookmark12 o Current Document 接口协议 6 HYPERLINK l bookmark14 o Current Docu

2、ment 返回JSON文档说明 6 HYPERLINK l bookmark16 o Current Document 返回header 参数说明 7 HYPERLINK l bookmark18 o Current Document 返回body参数说明 7备注 错误 !未定义书签。 HYPERLINK l bookmark20 o Current Document 三、记录仪列表接口 9 HYPERLINK l bookmark22 o Current Document 功能说明 9 HYPERLINK l bookmark24 o Current Document 处理过程 9 HYPE

3、RLINK l bookmark26 o Current Document 接口协议 9 HYPERLINK l bookmark28 o Current Document 返回JSON文档说明 10 HYPERLINK l bookmark30 o Current Document 返回header 参数说明 10 HYPERLINK l bookmark32 o Current Document 返回body参数说明 10备注 错误 !未定义书签。四、视频的获取接口12 TOC o 1-5 h z HYPERLINK l bookmark36 o Current Document 功能说明

4、 12 HYPERLINK l bookmark38 o Current Document 处理过程 12 HYPERLINK l bookmark40 o Current Document 接口协议 12 HYPERLINK l bookmark42 o Current Document 返回JSON文档说明 13 HYPERLINK l bookmark44 o Current Document 返回header 参数说明 13 HYPERLINK l bookmark46 o Current Document 返回body参数说明 14备注 错误!未定义书签。 HYPERLINK l b

5、ookmark48 o Current Document 五、视频、图片、音频的播放接口 17 HYPERLINK l bookmark50 o Current Document 功能说明 17 HYPERLINK l bookmark52 o Current Document 处理过程 17 HYPERLINK l bookmark54 o Current Document 接口协议 17返回视频、图片、音频的播放说明 17概述1 、目的方便其它系统能够方便地对接本系统， 能够方便地得到需要视频文件的播放地址， 能够调用本系统的播放页面。2、术语执法记录仪：又称警用执法记录仪或现场执法记录仪

6、，是一款集数码摄像、数码照相、对讲送话器功能于一身，能够对执法过程中进行动态、静态的现场情况数字化记录的便携式设备。以下简称记录仪。警翼DZZJ移动执法电子证据管理软件：由深圳警翼软件技术有限公司开发，用于对基层公安机关汇集的多媒体执法资料的查询与管理。本软件全面支持警翼采集工作站及警翼现场执法记录仪，可实现模块化组网模式，将基层用户与管理单位连成整体， 方便执法资料跨区域跨级别查询调用、 电子证据实现全局统一管理， 更有利于保护民警权益、规范民警执法。以下简称DZZJ 管理软件。3、约定为使得描述能够更加准确，文档中均给出了 json 示例，示例中所涉及的值并无特殊含义。特此说明。二、组织机

7、构列表接口功能说明提供给第三方管理平台查看、调用DZZJ管理软件的组织机构架构。处理过程1、对传入接口参数进行解析，返回对应页的组织机构架构信息；2、本接口默认返回第一页记录仪信息；3、每页默认返回50条组织机构信息。当返回组织机构信息不足50条时，表示已查询到当前组织机构信息的最后一页。接口协议URL(application/json;charset=utf-8)1、参数说明page查询第几页数据（每页 50条）返回JSON文档说明1、输入请求示例header:state:success,count:11，body:Array11返回header参数说明参数项数据类型数据长度是否可空说明st

8、atevarchar255否返回请求状态，success表7及清求成功，请求成功时，在body中显tk请求王体；countint11否返回请求主体的数量；返回body参数说明参数项数据类型数据长度是否可空说明idint11否组织机构idunit_novarchar255是组织机构编号unit_namevarchar255是组织机构名称parentidint11否上级组织机构idorderbyint2是组织机构排序3、返回主体:id:2,unit_no:2001,unit_name:XX 区公安局,parentid:1, orderby:1三、记录仪列表接口功能说明提供给第三方管理平台查看、调用

9、DZZJ管理软件的记录仪信息。处理过程1、对传入接口参数进行解析，返回对应页的记录仪信息；2、本接口默认返回第一页记录仪信息；3、每页默认返回50条组织机构信息。当返回组织机构信息不足50条时，表示已查询到当前组织机构信息的最后一页。接口协议URL(application/json;charset=utf-8)1、参数说明page查询第几页数据（每页 50条）返回JSON文档说明1、输入请求示例header:state:success,count:50，body:Array50返回header参数说明参数项数据类型数据长度是否可空说明statevarchar255否返回请求状态，success

10、表7及清求成功，请求成功时，在body中显tk请求王体；countint11否返回请求主体的数量；返回body参数说明参数项数据类型数据长度是否可空说明idint11否记录仪idhostnamevarchar255是记录仪持有人姓名hostcodevarchar255是记录仪持有人编号hostbodyvarchar255是记录仪编号unit_novarchar255是组织机构编号statevarchar2否0-正常；1-报障，2-报废；3、返回主体：id:35,hostname:宋江，hostcode:100099”,hostbody:1671518”,unit_no:1001,state:0

11、四、视频的获取接口功能说明提供给第三方管理平台查看、调用DZZJ管理软件的视频信息。处理过程1、对传入接口参数进行解析并校验，若参数不全或无效，则直接返回错误码和错误信息；2、通过检验后，显示对应页的视频数据信息；3、本接口默认返回第一页视频信息；4、每页默认返回50条组织机构信息。当返回组织机构信息不足50条时，表示已查询到当前组织机构信息的最后一页。接口协议URL(application/json;charset=utf-8)1、参数说明page查询第几页数据（每页 50条）begin_time上传时间（时间格式为 YYYY-mm-ddpolice_id警员编号org_code组织机构编号

12、返回JSON文档说明1、输入请求示例header:state:success,count:7，body:Array7返回header参数说明参数项数据类型数据长度是否可空说明statevarchar255否返回请求状态，success表示请求成功，请求成功时，在body中显tk请求王体；fail表tk请求失败，并返回失败信息；countint11否返回请求主体的数量；返回body参数说明参数项数据类型数据长度是否可空说明data_idint11否视频idcapture_datevarchar255是创建时间device_novarchar255是记录仪编号creation_datetimest

13、amp0是上传时间media_namevarchar255否文件名：机身编号软成日期file_namevarchar255是文件别名police_novarchar255是记录仪持有人编号org_novarchar255是组织机构编号org_namevarchar255是组织机构名称file_typevarchar255是文件类型serverurlvarchar255是文件上传的服务器地址playpositionvarchar255是播放相对位置thumbvarchar255是缩略图file_lengthvarchar255是文件长度(Byte)file_durationint11是视频的播放

14、时间长度(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:1671421”,creation_date:2016-10-24 14:53:25”,media_name:167142120000”,file_name:张飞 20000”,police_no:100000”, org_no:“2001”,org_name:XX 区公安局 ,file_type:MP4,serverurl:FTPServer,playposition:,thumb:,file_length:,file_duration:1200132,media_desc:afafaafa1111,upload_station_ip:,upload_station:WS06S02,thumburl_def:,thumburl:,