ICS 35.240 CCS L 77 3502 福 建 省 厦 门 市 地 方 标 准 DB3502/T 072.2—2021 公共安全视频图像系统运维技术规范 第 2 部分：接口 Technical specification for operation and maintenance of video and image system for public security—Part2:Interfaces 2021 - 12 - 21 发布 2022 - 01 - 03 实施 厦门市市场监督管理局 发 布 DB3502/T 072.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（资料性） 资源 URI ............................................................ 44 I DB3502/T 072.2—2021 前 言 本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 本文件为DB3502/T 072《公共安全视频图像系统运维技术规范》的第2部分。DB3502/T 072已发布 了以下部分： ——第 1 部分：总体要求； ——第 2 部分：接口； ——第 3 部分：数据元。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由厦门市安全技术防范协会提出。 本文件由厦门市公安局归口。 本文件起草单位：厦门市公安局、厦门市安全技术防范协会、厦门市标准化研究院、苏州科达科技 股份有限公司、厦门凯迪空间电子有限公司、杭州海康威视数字技术股份有限公司、罗普特科技集团股 份有限公司。 本文件主要起草人：李童、覃智泉、林三达、张茂林、庄毅滨、郭流流、陆通、柳少英、崔晓琳、 李钊茜、夏莉、李庚、陈耿斌。 II DB3502/T 072.2—2021 引 言 公共安全视频图像系统在打击犯罪、治安防控、社会治理以及服务民生方面发挥了重要的作用，公 共安全视频图像系统运维管理平台建设的统一和规范，将进一步提升公共安全视频图像系统运维的服 务水平，有利于视频图像行业的专业化、规范化发展。DB3502/T 072《公共安全视频图像系统运维技术 规范》旨在确立公共安全视频图像系统运维管理平台总体设计、接口、数据元的技术标准，为视频图像 系统运维管理平台的建设提供基础规范。 DB3502/T 072拟由三个部分构成： ——第 1 部分：总体要求。目的在于确立公共安全视频图像系统运维管理平台关键技术路线和软 件系统的组织形式，确保总体架构满足服务范围内公共安全视频图像系统运维需求，明确主 要功能模块和模块间的逻辑关系，避免“过度建设”并确保“必要建设”。 ——第 2 部分：接口。目的在于将公共安全视频图像系统运维管理平台对外接口标准化，明确接 口在安全性、完备性、一致性、易用性、稳定性方面的要求，并从本级一机一档管理系统、 下级公共安全视频图像系统运维管理平台、前端智能箱系统及其他应用系统接入等方面，明 确接入的实现方式，为保障建设质量及拓展应用范围提供技术支撑。 ——第 3 部分：数据元。通过标准化描述公共安全视频图像系统运维管理平台的数据元和数据模 型，构建标准化的数据环境，为建设数据共享、标准统一的公共安全视频图像运维管理体系 提供基础规范。 III DB3502/T 072.2—2021 公共安全视频图像系统运维技术规范 第 2 部分：接口 1 范围 本文件规定了公共安全视频图像系统运维管理平台的接口分类与协议结构、接口功能、接口资源描 述、接口等技术要求。 本文件适用于公共安全视频图像系统运维管理平台的规划设计、软件开发及接口协议的符合性测 试。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 28181 公共安全视频监控联网系统信息传输、交换、控制技术要求 GA/T 1400.4 公安视频图像信息应用系统 第4部分：接口协议要求 DB3502/T 072.1 公共安全视频图像系统运维技术规范 第1部分：总体要求 IETF RFC 2616 超文本传输协议-HTTP/1.1（Hypertext Transfer Protocol-HTTP/1.1） 3 术语和定义 GB/T 28181、GA/T 1400.4、DB3502/T 072.1界定的术语和定义适用于本文件。 4 缩略语 下列缩略语适用于本文件。 REST:表述性状态传递（Representational State Transfer） SNMP:简单网络管理协议（Simple Network Management Protocol） URI：统一资源标识符(Uniform Resource Identifier) 5 接口分类与协议结构 接口分类 公共安全视频图像系统运维管理平台接口为运维管理平台和各应用系统专业运维节点的对接接口。 一机一档管理系统作为资源汇聚中心，提供统一运维对象开放接口，各类接口交互实体关系见图1，接 口分类说明如下： ——运维系统对接接口用于公共安全视频图像系统运维管理平台和本级一机一档管理系统专业运 维节点、下级公共安全视频图像系统运维管理平台、前端智能箱系统专业运维节点及其他应 用系统专业运维节点之间的数据交互； 1 DB3502/T 072.2—2021 ——统一运维对象开放接口用于一机一档管理系统和公共安全视频图像系统运维管理平台、前端 智能箱系统专业运维节点及其他应用系统专业运维节点之间的数据交换。 统一运维对象 开放接口 统一运维对象 开放接口 本级一机一档 统一运维对象开放接口 运维系统对接接口 运维系统对接接口 前端智能箱系统对接接口 前端智能箱系统 专业运维节点 其它应用系统 专业运维节点 视频图像系统运维管理平台 运维系统对接接口 运维系统对接接口 统一运维对象开放接口 下级一机一档 下级视频图像系统运维管理平台 下级应用系统 专业运维节点 运维系统对接接口 图1 接口交互实体关系图 协议结构 5.2.1 所有接口交互信息定义为 REST 架构下的资源，使用 URI 唯一标识。 5.2.2 接口交互连接方式应支持 HTTP 长连接和短连接，实现机制应符合 IETF RFC 2616 中的相关规 定。 5.2.3 应用系统接口访问形式应符合附录 A 中的 A.3。 6 接口功能 公共功能 6.1.1 功能要求 应用系统专业运维节点对接运维管理平台应支持注册、心跳、告警通知、状态订阅、状态订阅通知 等公共功能。专有设备管理系统专业运维节点、前端智能箱系统专业运维节点对接运维管理平台，应支 持公共功能。其中： ——注册失败时，应延迟 300s 内的随机时间后重新注册； ——注册成功后，在 10s 内未交互信息则进行心跳保活； ——应用系统专业运维节点汇聚本系统相关的服务器、服务实例、子系统的异常告警及前端设备 告警，应上报运维管理平台。 2 DB3502/T 072.2—2021 6.1.2 告警 应用系统专业运维节点，汇聚对接应用系统的告警异常，应对通用应用服务异常告警进行抽象定义， 本文件定义部分通用告警类型： ——应用系统专业运维节点代理多个子系统时，各子系统对告警类型定义不完全一致情况下，和 运维管理平台对接时，应用系统专业运维节点在保证告警码在系统内唯一的前提下，可上报 自定义的告警类型； ——通用告警类型见附录 B 中的 B.1； ——告警属性见附录 B 中的 B.2； ——告警级别见附录 B 中的 B.3； ——告警来源分为应用系统专业运维节点内告警和邻近系统告警。 专用功能 6.2.1 运维系统对接接口 6.2.1.1 应用系统专业运维节点应支持服务实例维护，前端智能箱系统专业运维节点、专有设备管理 系统专业运维节点可不支持服务实例维护。应用系统内部服务实例有变更时，应调用服务实例增加、删 除或修改接口。 6.2.1.2 可按需提供应用系统专业运维节点之间系统间告警订阅、系统间告警订阅通知和状态订阅。 6.2.2 前端智能箱系统对接接口 6