ICS13.310 GA A 91 中华人民共和国公共安全行业标准 GA/T1400.4—2017 公安视频图像信息应用系统 第4部分：接口协议要求 Video and image information application system for pubic security- Part4:Interfaceprotocolrequirements 2017-05-31实施 2017-05-31发布 中华人民共和国公安部 发布 GA/T1400.4—2017 目 次 前言 1范围 2规范性引用文件 3术语、定义和缩略语· 3.1术语和定义 3.2缩略语 4接口分类与协议结构 4.1接口分类 4.2协议结构 5 接口功能 3 5.1 公共功能 5.2 采集接口 5.3 数据服务接口 5.4 级联接口 5.5 分析接口 6接口资源描述 6.1 视图库资源描述 6.2 分析系统资源描述， 10 7接口消息 11 7.1 接口消息描述 11 7.2 视图库接口消息 12 7.3 分析系统接口消息· 27 8 消息交互流程 32 8.1 创建资源消息交互流程 32 8.2 读取资源消息交互流程 32 8.3 更新资源消息交互流程 33 8.4删除资源消息交互流程 33 9消息交互安全性 34 附录A（规范性附录） REST架构协议模型 附录B（资料性附录） 关键消息交互流程示例 38 GA/T1400.4—2017 前言 GA/T1400《公安视频图像信息应用系统》分为4个部分： 第1部分：通用技术要求； 第2部分：应用平台技术要求； —第3部分：数据库技术要求； 一第4部分：接口协议要求。 本部分是GA/T1400的第4部分。 本部分按照GB/T1.1一2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不应承担识别这些专利的责任。 本部分由公安部科技信息化局提出。 本部分由全国安全防范报警系统标准化技术委员会（SAC/TC100)归口。 本部分起草单位：公安部科技信息化局、公安部第一研究所、北京中盾安全技术开发公司、浙江立元 通信技术股份有限公司、浙江宇视科技有限公司、杭州海康威视数字技术股份有限公司、东方网力科技 股份有限公司、浙江大华技术股份有限公司、国家安全防范报警系统产品质量监督检验中心（北京）、苏 州科达科技股份有限公司、天津天地伟业数码科技有限公司。 本文件主要起草人：孙丽丽、赵惠芳、赵问道、赵源、庄超明、崔云红、王建勇、张晓琳、赵世范、杜云鹏、 孔维生、廖双龙、张翔、覃明贵、杨清永。 本部分于2017年首次发布。 I GA/T1400.4—2017 公安视频图像信息应用系统 第4部分：接口协议要求 1范围 本部分规定了公安视频图像信息应用系统的接口分类与协议结构、接口功能、接口资源描述、接口 消息、消息交互流程、消息交互安全性等技术要求。 本部分适用于公安视图像信息应用系统的规划设计、软件开发及接口协议的符合性测试。 2规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T281812016 公共安全视频监控联网系统信息传输、交换、控制技术要求 GA/T669.1—2008 3城市监控报警联网系统技术标准第1部分：通用技术要求 GA/T669.7—2008 城市监控报警联网系统技术标准第7部分：管理平台技术要求 GA/T1399—2017公安视频图像分析系统 GA/T1400.1—2017 公安视频图像信息应用系统第1部分：通用技术要求 GA/T1400.2—2017 公安视频图像信息应用系统第2部分：应用平台技术要求 GA/T1400.3—2017 公安视频图像信息应用系统第3部分：数据库技术要求 IETFRFC2045 5多用途网际邮件扩充协议（MIME）第一部分：Internet信息体格式（Multipur- pose Internet Mail Extensions (MIME)Part One:Format of Internet MessageBodies) IETFRFC2616 超文本传输协议-HTTP/1.1（HypertextTransferProtocol-HTTP/1.1)） IETFRFC2617 HTTP基本认证与摘要访问认证（HTTPAuthentication：BasicandDigestAc- cesss Authentication) IETFRFC2818 3安全超文本传输协议（HTTPOverTLS） 3术语、定义和缩略语 3.1术语和定义 GB/T28181--2016GA/T669.1—2008GA/T669.7—2008、GA/T1399—2017、GA/T1400.1— 2017、GA/T1400.2一2017和GA/T1400.3一2017中界定的术语、定义适用于本文件。 3.2缩略语 GB/T28181—2016、GA/T669.1—2008、GA/T669.7—2008,GA/T1399—2017、GA/T1400.1- 2017、GA/T1400.2一2017和GA/T1400.3一2017中界定的缩略语适用于本文件。此外，下列缩略语 适用于本文件。 C：创建(Create) CR：创建和读取（CreateandRetrieve） 1 GA/T1400.4—2017 CRD：创建、读取和删除（Create，RetrieveandDelete） R：读取(Retrieve) RU:读取和更新(RetrieveandUpdate) RUD：读取、更新和删除（Retrieve，UpdateandDelete) U：更新(Update) 4接口分类与协议结构 4.1接口分类 4.1.1公安视频图像信息应用系统（以下简称应用系统）的接口包括采集接口、数据服务接口、级联接 口和分析接口，各类接口交互实体关系见图1。 公安视频图像 公安视频图像信息 分析设备/系统 数据库 分析接口 数据服务/采集接口 级联接口 在线视频图像信息 公安视频图像信息 采集设备 应用平台 公安视频图像信息 数据库 在线视频图像信息 其他信息系统 采集系统 采集接口 数据服务接口 图1接口交互实体关系图 4.1.2采集接口用于公安视频图像信息数据库（以下简称视图库）与在线视频图像信息采集设备（以下 简称采集设备）、在线视频图像信息采集系统（以下简称采集系统）、公安视频图像分析系统（以下简称分 析系统)之间数据的交互。 4.1.3数据服务接口用于视图库与公安视频图像信息应用平台（以下简称应用平台）、分析系统、其他 信息系统等之间数据的交互。 4.1.4级联接口用于视图库与视图库之间数据的交互。 4.1.5分析接口用于分析系统与应用平台之间数据的交互。 4.2协议结构 4.2.1接口协议结构应符合GA/T1400.1一2017中的规定。 4.2.2所有接口交互信息定义为REST架构下的资源，使用URI唯一标识。根据GA/T1400.1一 2017中的规定，接口对应资源使用树状层级结构组织。 4.2.3接口交互连接方式应支持HTTP长连接和短连接，实现机制应符合IETFRFC2616中的相关 规定。 4.2.4应用系统接口访问形式应符合附录A中的A.3。 4.2.5HTTP请求头域中应扩展增加<User-Identify），携带请求者的系统用户ID等身份属性，用于标 识请求者。 2 GA/T1400.4—2017 5 接口功能 5.1 公共功能 5.1.1） 应支持注册、保活、注销、校时。注册失败时，应延迟300s内的随机时间后重新注册。注册成功 后，在90s内未交互信息则进行心跳保活。注册、保活、注销与第7章接口消息的对照关系见表1。 表1 注册、保活、注销与接口消息对照表 序号 功能 对应接口消息章节 执行方法 1 注册 7.2.1,7.3.1 POST 2 注销 7.2.2,7.3.2 POST 3 保活 7.2.3,7,3.3 POST 校时 4 7.2.4,7.3.4 GET 5.2 采集接口 5.2.1 集视频图像信息与第7章接口消息对照关系见表2。上传信息后，若在一定延迟时间（例如5s）内未接 收到响应，则视为上传失败，应重传。如连续多次（例如3次）重传仍未成功，则视为链路发生问题，缓存 信息，并重新进行注册。在注册成功后，补传所有未报送数据。 表2上传自动采集视频图像信息与接口消息对照表 序号 功能 对应接口消息章节 执行方法 1 上传自动采集视频片段 7.2.8.1 POST 2 上传自动采集视频片段数据 7,2.8.4 POST 3 上传自动采集图像 7.2.9.1 POST 4 上传自动采集图像数据 7,2.9.4 POST 5 上传自动采集文件 7,2.10.1 POST 9 上传自动采集文件数据 7,2.10.4 POST 7 上传自动采集人员 7.2.11.1 POST 上传自动采集人脸 7,2.12.1 POST 6 上传自动采集机动车 7.2.13.1 POST 10 上传自动采集非机动车 7.2.14.1 POST 11 上传自动采集物品 7.2.15.1 POST 12 上传自动采集场景 7.2.16.1 POST 13 上传自动采集视频图像标签 7,2.23.1 POST 5.2.2 进行口令等信息的更改，查询采集设备列表、更改口令与第7章接口消息对照关系见表3。 3