GA/T 1400.4-2017 公安视频图像信息应用系统 第4部分：接口协议要求

ICS13.310

A91

中华人民共和国公共安全行业标准

/—

GAT1400.42017

公安视频图像信息应用系统

:

第部分接口协议要求

4

ㅤㅤㅤㅤ

Videoandimaeinformationalicationsstemforubicsecurit—

gppypy

:

Part4Interfacerotocolreuirements

pq

2017-05-31发布2017-05-31实施

中华人民共和国公安部发布

/—

GAT1400.42017

目次

前言…………………………Ⅰ

1范围………………………1

2规范性引用文件…………………………1

、

3术语定义和缩略语………………………1

3.1术语和定义…………………………1

3.2缩略语………………1

4接口分类与协议结构……………………2

4.1接口分类……………2

4.2协议结构……………2

5接口功能…………………3

5.1公共功能……………3

5.2采集接口……………3

5.3数据服务接口………………………4

5.4级联接口……………7

5.5分析接口……………7

ㅤㅤㅤㅤ

6接口资源描述……………8

6.1视图库资源描述……………………8

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架构协议模型35

()…………

附录资料性附录关键消息交互流程示例

B38

/—

GAT1400.42017

公安视频图像信息应用系统

:

第部分接口协议要求

4

1范围

、、、

本部分规定了公安视频图像信息应用系统的接口分类与协议结构接口功能接口资源描述接口

、、。

消息消息交互流程消息交互安全性等技术要求

、。

本部分适用于公安视频图像信息应用系统的规划设计软件开发及接口协议的符合性测试

2规范性引用文件

。,

下列文件对于本文件的应用是必不可少的凡是注日期的引用文件仅注日期的版本适用于本文

。,()。

件凡是不注日期的引用文件其最新版本包括所有的修改单适用于本文件

/—、、

GBT281812016公共安全视频监控联网系统信息传输交换控制技术要求

/—:

城市监控报警联网系统技术标准第部分通用技术要求

GAT669.120081

/—:

城市监控报警联网系统技术标准第部分管理平台技术要求

GAT669.720087

/—公安视频图像分析系统

GAT13992017

/—:

公安视频图像信息应用系统第部分通用技术要求

ㅤㅤㅤㅤ

GAT1400.120171

/—:

公安视频图像信息应用系统第部分应用平台技术要求

GAT1400.220172

/—:

公安视频图像信息应用系统第部分数据库技术要求

GAT1400.320173

IETFRFC2045多用途网际邮件扩充协议()第一部分:信息体格式(

MIMEInternetMultiur-

p

():)

oseInternetMailExtensionsMIMEPartOneFormatofInternetMessaeBodies

pg

超文本传输协议/(/)

IETFRFC2616-HTTP1.1HertextTransferProtocol-HTTP1.1

yp

IETFRFC2617HTTP基本认证与摘要访问认证(:

HTTPAuthenticationBasicandDiestAc-

g

cesssAuthentication)

IETFRFC2818安全超文本传输协议(HTTPOverTLS)

、

3术语定义和缩略语

3.1术语和定义

/—、/—、/—、/—、/—

GBT281812016GAT669.12008GAT669.72008GAT13992017GAT1400.1

、/—/—、。

和中界定的术语定义适用于本文件

2017GAT1400.22017GAT1400.32017

3.2缩略语

/—、/—、/—、/—、/—

GBT281812016GAT669.12008GAT669.72008GAT13992017GAT1400.1

、/—/—。,

和中界定的缩略语适用于本文件此外下列缩略语

2017GAT1400.22017GAT1400.32017

适用于本文件。

:()

C创建Create

:()

CR创建和读取CreateandRetrieve

1

/—

GAT1400.42017

:、(,)

CRD创建读取和删除CreateRetrieveandDelete

:()

R读取Retrieve

:()

RU读取和更新RetrieveandUdate

p

:、(,)

RUD读取更新和删除RetrieveUdateandDelete

p

:()

U更新Udate

p

4接口分类与协议结构

4.1接口分类

()、、

4.1.1公安视频图像信息应用系统以下简称应用系统的接口包括采集接口数据服务接口级联接

,。

口和分析接口各类接口交互实体关系见图1

ㅤㅤㅤㅤ

图接口交互实体关系图

1

()(

4.1.2采集接口用于公安视频图像信息数据库以下简称视图库与在线视频图像信息采集设备以下

)、()、(

简称采集设备在线视频图像信息采集系统以下简称采集系统公安视频图像分析系统以下简称分

)。

析系统之间数据的交互

()、、

4.1.3数据服务接口用于视图库与公安视频图像信息应用平台以下简称应用平台分析系统其他

信息系统等之间数据的交互。

4.1.4级联接口用于视图库与视图库之间数据的交互。

4.1.5分析接口用于分析系统与应用平台之间数据的交互。

4.2协议结构

接口协议结构应符合/—中的规定。

4.2.1GAT1400.12017

,。/—

4.2.2所有接口交互信息定义为REST架构下的资源使用URI唯一标识根据GAT1400.1

,。

2017中的规定接口对应资源使用树状层级结构组织

,中的相关

4.2.3接口交互连接方式应支持HTTP长连接和短连接实现机制应符合IETFRFC2616

规定。

应用系统接口访问形式应符合附录中的。

4.2.4AA.3

请求头域中应扩展增加<>,,

4.2.5HTTPUser-Identif携带请求者的系统用户等身份属性用于标

yID

识请求者。

2

/—

GAT1400.42017

5接口功能

5.1公共功能

、、、。,。

5.1.1应支持注册保活注销校时注册失败时应延迟300s内的随机时间后重新注册注册成功

,。、、。

后在内未交互信息则进行心跳保活注册保活注销与第章接口消息的对照关系见表

90s71

、、

表1注册保活注销与接口消息对照表

序号功能对应接口消息章节执行方法

注册、

1.1POST

注销、

2.2POST

保活、

3.3POST

校时、

4.4GET

5.2采集接口

、、,

5.2.1应支持采集设备采集系统分析系统向视图库进行自动采集视频图像信息的上传上传自动采

。,()内未接

集视频图像信息与第章接口消息对照关系见表上传信息后若在一定延迟时间例如5s

72

,,。(),,

收到响应则视为上传失败应重传如连续多次例如次重传仍未成功则视为链路发生问题缓存

3

,。,。

信息并重新进行注册在注册成功后补传所有未报送数据

ㅤㅤㅤㅤ

表2上传自动采集视频图像信息与接口消息对照表

序号功能对应接口消息章节执行方法

1上传自动采集视频片段POST

2上传自动采集视频片段数据POST

3上传自动采集图像POST

4上传自动采集图像数据POST

5上传自动采集文件POST

6上传自动采集文件数据POST

7上传自动采集人员POST

8上传自动采集人脸POST

9上传自动采集机动车POST

10上传自动采集非机动车POST

11上传自动采集物品POST

12上传自动采集场景POST

13上传自动采集视频图像标签POST

、、,

5.2.2应支持视图库向采集系统进行采集设备或采集系统视频卡口车道等信息的查询向采集设备

,、。

进行口令等信息的更改查询采集设备列表更改口令与第章接口消息对照关系见表

73

3

/—

GAT1400.42017

、

表3查询采集设备列表更改口令与接口消息对照表

序号功能对应接口消息章节执行方法

1查询采集设备7.2.5GET

2更改采集设备口令7.2.5PUT

3查询采集系统7.2.6GET

4查询视频卡口GET

5查询车道GET

,

应支持分析系统向视图库进行视频图像分析规则的上传上传视频图像分析规则与第章接口

5.2.37

消息对照关系见表4。

表4上传视频图像分析规则与接口消息对照表

序号功能对应接口消息章节执行方法

1上传视频图像分析规则POST

5.3数据服务接口

、

5.3.1应支持应用平台其他信息系统等向视图库进行基于视频图像信息对象等特征属性及其组合的

,。

查询支持分析系统向视图库进行基于视频图像信息对象等特征属性及其组合的查询特征属性查询

ㅤㅤㅤㅤ

与第章接口消息对照关系见表。

75

表5特征属性及其组合查询与接口消息对照表

序号功能对应接口消息章节执行方法

1批量查询视频片段GET

2查询单个视频片段GET

3查询视频片段对象信息GET

4下载视频片段数据GET

5批量查询图像GET

6查询单个图像GET

7查询图像对象信息GET

8下载图像数据GET

9查询文件GET

10查询单个文件GET

11查询文件对象信息GET

12下载文件数据GET

13查询人员GET

14查询单个人员GET

15批量查询人脸GET

4

/—

GAT1400.42017

表()

5续

序号功能对应接口消息章节执行方法

16查询单个人脸GET

17批量查询机动车GET

18查询单个机动车GET

19批量查询非机动车GET

20查询单个非机动车GET

21批量查询物品GET

22查询单个物品GET

23批量查询场景GET

24查询单个场景GET

25批量查询视频案事件GET

26查询单个视频案事件GET

27查询视频案事件对象信息GET

28查询布控任务GET

29查询告警记录GET

30查询订阅任务GET

查询通知记录ㅤㅤㅤㅤ

31GET

32查询视频图像分析规则GET

33查询视频图像标签GET

、

5.3.2应支持应用平台其他信息系统等向视图库进行人工采集视频案事件及视频图像信息对象的创

、、,。

建更新删除人工采集视频图像信息对象与第章接口消息对照关系见表

76

表6人工采集视频图像信息对象与接口消息对照表

序号功能对应接口消息章节执行方法

1批量创建视频案事件POST

、、

2更新删除单个视频案事件PUTDELETE

、、

3更新删除视频案事件对象信息PUTDELETE

4批量创建人工采集视频片段POST

、、

5更新删除人工采集单个视频片段PUTDELETE

、、

6更新删除人工采集视频片段对象信息PUTDELETE

、、

7创建删除人工采集视频片段数据POSTDELETE

8批量创建人工采集图像POST

、、

9更新删除人工采集单个图像PUTDELETE

、、

10更新删除人工采集图像对象信息PUTDELETE

、、

11创建删除人工采集图像数据POSTDELETE

5

/—

GAT1400.42017

表()

6续

序号功能对应接口消息章节执行方法

12批量创建人工采集文件POST

、、

13更新删除人工采集单个文件PUTDELETE

、、

14更新删除人工采集文件对象信息PUTDELETE

、、

15创建删除人工采集文件数据POSTDELETE

、、、、

16批量创建更新删除人员POSTPUTDELETE

、、

17更新删除单个人员PUTDELETE

、、、、

18批量创建更新删除人脸POSTPUTDELETE

、、

19更新删除单个人脸PUTDELETE

、、、、

20批量创建更新删除机动车POSTPUTDELETE

、、

21更新删除单个机动车PUTDELETE

、、、、

22批量创建更新删除非机动车POSTPUTDELETE

、、

23更新删除单个非机动车POSTDELETE

、、、、

24批量创建更新删除物品POSTPUTDELETE

、、

25更新删除单个物品PUTDELETE

ㅤㅤㅤㅤ

、、、、

26批量创建更新删除场景POSTPUTDELETE

、、

27更新删除单个场景PUTDELETE

、、、、

28创建更新删除视频图像标签POSTPUTDELETE

、、、、

29批量创建更新删除视频图像分析规则POSTPUTDELETE

、、,、

5.3.3应支持应用平台其他信息系统等向视图库进行采集设备或采集系统等的查询更新查询更

新采集设备或采集系统与第章接口消息对照关系见表。

77

、

表7查询更新采集设备或采集系统与接口消息对照表

序号功能对应接口消息章节执行方法

1查询采集设备7.2.5GET

2更改采集设备口令7.2.5PUT

3查询采集系统7.2.6GET

4查询视频卡口GET

5查询车道GET

、,

5.3.4应支持应用平台其他信息系统等与视图库之间进行视频图像信息对象的布控与告警布控告

警与第章接口消息对照关系见表。

78

6

/—

GAT1400.42017

表8布控告警与接口消息对照表

序号功能对应接口消息章节执行方法

1批量布控POST

、、

2批量更新删除布控任务PUTDELETE

3撤控PUT

4告警POST

5删除告警记录DELETE

、、

5.3.5应支持应用平台其他信息系统等与视图库之间进行视频图像信息对象采集设备或采集系统

,。,

目录等的订阅与通知订阅通知与第章接口消息对照关系见表通知发出后若在一定延迟时间

79

(),,。(),

例如内未接收到响应则视为通知失败应重传如连续多次例如次重传仍未成功则视为