DB3502/T 072.2-2021 公共安全视频图像系统运维技术规范 第2部分：接口

ICS35.240

CCSL77

3502

福建省厦门市地方标准

DB3502/T072.2—2021

公共安全视频图像系统运维技术规范

第2部分：接口

Technicalspecificationforoperationandmaintenanceofvideoandimagesystemfor

publicsecurity—Part2:Interfaces

2021-12-21发布2022-01-03实施

厦门市市场监督管理局发布

DB3502/T072.2—2021

目次

前言II

引言III

1范围1

2规范性引用文件1

3术语和定义1

4缩略语1

5接口分类与协议结构1

6接口功能2

7接口资源描述3

8接口3

附录A（资料性）REST架构协议模型39

附录B（资料性）告警42

附录C（资料性）资源URI44

I

DB3502/T072.2—2021

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

本文件为DB3502/T072《公共安全视频图像系统运维技术规范》的第2部分。DB3502/T072已发布

了以下部分：

——第1部分：总体要求；

——第2部分：接口；

——第3部分：数据元。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由厦门市安全技术防范协会提出。

本文件由厦门市公安局归口。

本文件起草单位：厦门市公安局、厦门市安全技术防范协会、厦门市标准化研究院、苏州科达科技

股份有限公司、厦门凯迪空间电子有限公司、杭州海康威视数字技术股份有限公司、罗普特科技集团股

份有限公司。

本文件主要起草人：李童、覃智泉、林三达、张茂林、庄毅滨、郭流流、陆通、柳少英、崔晓琳、

李钊茜、夏莉、李庚、陈耿斌。

II

DB3502/T072.2—2021

引言

公共安全视频图像系统在打击犯罪、治安防控、社会治理以及服务民生方面发挥了重要的作用，公

共安全视频图像系统运维管理平台建设的统一和规范，将进一步提升公共安全视频图像系统运维的服

务水平，有利于视频图像行业的专业化、规范化发展。DB3502/T072《公共安全视频图像系统运维技术

规范》旨在确立公共安全视频图像系统运维管理平台总体设计、接口、数据元的技术标准，为视频图像

系统运维管理平台的建设提供基础规范。

DB3502/T072拟由三个部分构成：

——第1部分：总体要求。目的在于确立公共安全视频图像系统运维管理平台关键技术路线和软

件系统的组织形式，确保总体架构满足服务范围内公共安全视频图像系统运维需求，明确主

要功能模块和模块间的逻辑关系，避免“过度建设”并确保“必要建设”。

——第2部分：接口。目的在于将公共安全视频图像系统运维管理平台对外接口标准化，明确接

口在安全性、完备性、一致性、易用性、稳定性方面的要求，并从本级一机一档管理系统、

下级公共安全视频图像系统运维管理平台、前端智能箱系统及其他应用系统接入等方面，明

确接入的实现方式，为保障建设质量及拓展应用范围提供技术支撑。

——第3部分：数据元。通过标准化描述公共安全视频图像系统运维管理平台的数据元和数据模

型，构建标准化的数据环境，为建设数据共享、标准统一的公共安全视频图像运维管理体系

提供基础规范。

III

DB3502/T072.2—2021

公共安全视频图像系统运维技术规范

第2部分：接口

1范围

本文件规定了公共安全视频图像系统运维管理平台的接口分类与协议结构、接口功能、接口资源描

述、接口等技术要求。

本文件适用于公共安全视频图像系统运维管理平台的规划设计、软件开发及接口协议的符合性测

试。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

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

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

DB3502/T072.1公共安全视频图像系统运维技术规范第1部分：总体要求

IETFRFC2616超文本传输协议-HTTP/1.1（HypertextTransferProtocol-HTTP/1.1）

3术语和定义

GB/T28181、GA/T1400.4、DB3502/T072.1界定的术语和定义适用于本文件。

4缩略语

下列缩略语适用于本文件。

REST:表述性状态传递（RepresentationalStateTransfer）

SNMP:简单网络管理协议（SimpleNetworkManagementProtocol）

URI：统一资源标识符(UniformResourceIdentifier)

5接口分类与协议结构

接口分类

公共安全视频图像系统运维管理平台接口为运维管理平台和各应用系统专业运维节点的对接接口。

一机一档管理系统作为资源汇聚中心，提供统一运维对象开放接口，各类接口交互实体关系见图1，接

口分类说明如下：

——运维系统对接接口用于公共安全视频图像系统运维管理平台和本级一机一档管理系统专业运

维节点、下级公共安全视频图像系统运维管理平台、前端智能箱系统专业运维节点及其他应

用系统专业运维节点之间的数据交互；

1

DB3502/T072.2—2021

——统一运维对象开放接口用于一机一档管理系统和公共安全视频图像系统运维管理平台、前端

智能箱系统专业运维节点及其他应用系统专业运维节点之间的数据交换。

统一运维对象统一运维对象

开放接口开放接口

本级一机一档

统一运维对象开放接口运维系统对接接口

前端智能箱系统对接接口运维系统对接接口

前端智能箱系统视频图像系统运维管理平台其它应用系统

专业运维节点专业运维节点

运维系统对接接口

统一运维对象开放接口运维系统对接接口

下级应用系统

下级一机一档下级视频图像系统运维管理平台

专业运维节点

运维系统对接接口

图1接口交互实体关系图

协议结构

5.2.1所有接口交互信息定义为REST架构下的资源，使用URI唯一标识。

5.2.2接口交互连接方式应支持HTTP长连接和短连接，实现机制应符合IETFRFC2616中的相关规

定。

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

6接口功能

公共功能

6.1.1功能要求

应用系统专业运维节点对接运维管理平台应支持注册、心跳、告警通知、状态订阅、状态订阅通知

等公共功能。专有设备管理系统专业运维节点、前端智能箱系统专业运维节点对接运维管理平台，应支

持公共功能。其中：

——注册失败时，应延迟300s内的随机时间后重新注册；

——注册成功后，在10s内未交互信息则进行心跳保活；

——应用系统专业运维节点汇聚本系统相关的服务器、服务实例、子系统的异常告警及前端设备

告警，应上报运维管理平台。

2

DB3502/T072.2—2021

6.1.2告警

应用系统专业运维节点，汇聚对接应用系统的告警异常，应对通用应用服务异常告警进行抽象定义，

本文件定义部分通用告警类型：

——应用系统专业运维节点代理多个子系统时，各子系统对告警类型定义不完全一致情况下，和

运维管理平台对接时，应用系统专业运维节点在保证告警码在系统内唯一的前提下，可上报

自定义的告警类型；

——通用告警类型见附录B中的B.1；

——告警属性见附录B中的B.2；

——告警级别见附录B中的B.3；

——告警来源分为应用系统专业运维节点内告警和邻近系统告警。

专用功能

6.2.1运维系统对接接口

应用系统专业运维节点应支持服务实例维护，前端智能箱系统专业运维节点、专有设备管理

系统专业运维节点可不支持服务实例维护。应用系统内部服务实例有变更时，应调用服务实例增加、删

除或修改接口。

可按需提供应用系统专业运维节点之间系统间告警订阅、系统间告警订阅通知和状态订阅。

6.2.2前端智能箱系统对接接口

应支持设备列表查询功能，运维管理平台通过接口查询前端智能箱系统关联的智能箱列表，

和一机一档管理系统的设备信息进行比对分析，查找是否存在设备冲突。

应支持智能控制功能，对前端智能箱系统管理的智能箱进行重启、开关电等操作。

6.2.3统一运维对象开放接口

应支持向一机一档管理系统查询设备信息，响应一机一档管理系统状态结果通知。

7接口资源描述

资源URI

7.1.1运维系统资源URI见附录C中的C.1。

7.1.2应用系统资源URI见附录C中的C.2。

7.1.3一机一档管理系统资源URI见附录C中的C.3。

8接口

运维系统对接接口

8.1.1注册

交互流程

注册交互流程见图2，信令流程描述如下：

3

DB3502/T072.2—2021

a)应用系统专业运维节点向运维管理平台POST发送/nms/v1/register请求。应用系统专业运维

节点可以是前端智能箱系统专业运维节点、下级运维管理平台、专有设备管理系统专业运维节

点等运维节点；

b)运维管理平台将注册成功与否的响应返回给发起者。

专业运维节点运维管理平台

1POST/nms/v1/register

2response

图2注册交互流程图

流程示意图

注册流程示意图见图3。

专业运维节点

向运维管理平台发送

/nms/v1/register

进行注册

注册失败专业运维节点注

注册处理

册异常处理

注册成功

注册完成

图3注册流程示意图

注册功能描述

注册功能描述见表1。

4

DB3502/T072.2—2021

表1注册功能描述表

URI/nms/v1/register

功能注册

HTTP方法POST

{

"id":"35020000001370000218",

请求消息体

"password":"xxxx"

}

（R）id：一机一档管理系统分配应用系统专业运维节点国标id

请求说明

（O）password：加密后的IDBASE64编码

{

"code":0,

"data":{

返回结果"token":"a.b.c",

},

"message":""

}

Tokenpayload内容为

{

"exp":1554821260,--过期时间

"iat":1547608753--生成时间

结果说明

}

在过期时间之前调用方需要重新调用register接口获取新的token

Token值放入后续请求header的authorization字段中标记已经登录过

Authorization:Bearera.b.c

注：R为必选项，O为可选项。

8.1.2心跳

交互流程

心跳交互流程见图4，信令流程描述如下：

a)应用系统专业运维节点定时向运维管理平台GET发送/nms/v1/heartbeat/{id}请求；

b)运维管理平台将心跳成功与否的响应返回给发起者。

5

DB3502/T072.2—2021

专业运维节点运维管理平台

1GET/nms/v1/heartbeat/{id}

2response

图4心跳交互流程图

流程示意图

心跳流程示意图见图5。

专业运维节点

向运维管理平台发送

/nms/v1/heartbeat/{id}

未接收到心跳

数据或心跳失

运维管理平台接败专业运维节点心

收心跳数据情况跳保活异常处理

心跳成功

结束

图5心跳流程示意图

心跳功能描述

心跳功能描述见表2。

6

DB3502/T072.2—2021

表2心跳功能描述表

URI/nms/v1/heartbeat/{id}

功能应用系统专业运维节点心跳接口

HTTP方法GET

请求参数id

请求消息体无

请求说明(R)id：一机一档管理系统分配应用系统专业运维节点国标id

{

"code":0,

返回结果

"message":""

}

结果说明注册后，定时向运维管理平台发送心跳保活消息，建议10秒一次

注：R为必选项，O为可选项。

8.1.3服务实例维护

交互流程

服务实例维护交互流程见图6，信令流程描述如下：

a)应用系统专业运维节点向运维管理平台发送/nms/v1/serviceInstance增加、修改、删除请求；

b)运维管理平台将操作成功与否的响应返回给发起者。

专业运维节点运维管理平台

1POST/PUT/DELETE/nms/v1/serviceInstance

2response

图6服务实例维护交互流程图

流程示意图

服务实例维护流程示意图见图7。

7

DB3502/T072.2—2021

专业运维节点

向运维管理平台发送

/nms/v1/serviceInstance

增删改请求

处理失败

运维管理平台接收专业运维节点服务

服务实例维护处理实例维护异常处理

处理成功

结束

图7服务实例维护流程示意图

增加服务实例功能描述

增加服务实例功能描述见表3。

表3增加服务实例功能描述表

URI/nms/v1/serviceInstance

功能增加服务实例，可批量添加

HTTP方法POST

[{

"hardwareID":"xxxx",

请求消息体"systemID":"xxxx",

"name":"流媒体微服务"

}]

（R）hardwareID：服务所属设备ID

请求说明（O）systemID：服务所属系统ID

（R）name：服务名称

{

"code":0,

"data":[{

返回结果

"hardwareID":"xxxx",

"systemID":"xxxx",

"id":"xxxxxxxx"

8

DB3502/T072.2—2021

表3（续）

}],

返回结果"message":""

}

（R）id：一机一档管理系统分配ID

结果说明（R）hardwareID：服务所属设备ID

（O）systemID：服务所属系统ID

注：R为必选项，O为可选项。

修改服务实例功能描述

修改服务实例功能描述见表4。

表4修改服务实例功能描述表

URI/nms/v1/serviceInstance

功能修改服务实例，只允许修改hardwareID（即服务和硬件设备对应关系）

HTTP方法PUT

[{

"id":"xxxx",

"hardwareID":"xxxx",

请求消息体

"systemID":"xxxx",

"name":"流媒体微服务"

}]

（R）id：服务实例ID（一机一档管理系统分配）

（R）hardwareID：服务所属设备ID

请求说明

（O）systemID：服务所属系统ID

（R）name：服务名称

{

"code":0,

返回结果

"message":""

}

结果说明—

注：R为必选项，O为可选项。

删除服务实例功能描述

删除服务实例功能描述见表5。

9

DB3502/T072.2—2021

表5删除服务实例功能描述表

URI/nms/v1/serviceInstance/{id}

功能删除服务实例

HTTP方法DELETE

请求消息体id

请求说明（R）id：服务实例ID（一机一档管理系统分配）

{

"code":0,

"data":{

返回结果"id":"xxxxxxxx"

},

"message":""

}

结果说明—

注：R为必选项，O为可选项。

8.1.4告警通知

交互流程

告警通知交互流程见图8，信令流程描述如下：

a)应用系统专业运维节点向运维管理平台发送/nms/v1/alarm告警通知；

b)运维管理平台将操作成功与否的响应返回给发起者。

专业运维节点运维管理平台

1POST/nms/v1/alarm

2response

图8告警通知交互流程图

10

DB3502/T072.2—2021

流程示意图

告警通知流程示意图见图9。

专业运维节点

向运维管理平台发送

/nms/v1/alarm

运维管理平台处理失败专业运维节点告

接收告警通知警通知异常处理

处理成功

结束

图9告警通知流程示意图

告警通知功能描述

告警通知功能描述见表6。

表6告警通知功能描述表

URI/nms/v1/alarm

功能告警通知接口

HTTP方法POST

{

"timestamp":15427016032,

"alarmMsgs":[{

"id":"31010600001320000009",

"name":"kafka实例",

"sourceId":"31010600005200000009",

请求消息体

"sourceName":"人脸检测系统专业运维节点",

"alarmCode":70001,

"alarmLevel":1,

"alarmStatus":1,

"alarmTime":13234343,

"ip":"设备IP",

11

DB3502/T072.2—2021

表6（续）

"alarmDesc":"告警描述",

"alarmDeal":"处理建议"

"noticePerson":0,

请求消息体

"attachment":"6Ieq5a6a5LmJ5pWw5o2u"

}]

}

(R)id：运维对象ID，可以是系统运维节点ID、系统ID、后端服务器设备ID、服务实例ID或

前端设备ID

(R)name：运维对象名称

(O)sourceId：运维节点ID，如果告警对象就是运维节点，该字段可不填写

(O)sourceName：运维节点名称

(R)alarmCode：告警码

(R)alarmLevel：告警级别（见附录表B.3）

请求说明

(R)alarmStatus：告警状态（0：恢复/1：告警）

(R)alarmTime：告警时间

(O)ip:设备IP

(R)alarmDesc：告警描述

(O)alarmDeal：处理建议

(O)noticePerson：是否通知到人

(O)attachment：附加运维信息，需要Base64编码

{

"code":0,

返回结果

"message":""

}

结果说明—

注：R为必选项，O为可选项。

8.1.5状态订阅

交互流程

状态订阅交互流程见图10，信令流程描述如下：

a)运维管理平台向应用系统专业运维节点发送/subsystem/v1/subscirbe订阅请求；

b)应用系统专业运维节点将操作成功与否的响应返回给运维管理平台。

12

DB3502/T072.2—2021

运维管理平台专业运维节点

1POST/subsystem/v1/subscirbe

2response

图10状态订阅交互流程图

流程示意图

状态订阅流程示意图见图11。

运维管理平台

向专业运维节点发送

/subsystem/v1/subscirb