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

3502Technicalspecificationforoperationandmaintenanceofvideoandimagesystemforpublicsecurity—Part2:InterfacesI 2 3 3 本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定本文件为DB3502/T072《公共安全视频图像系统运维技术规范》的第2部分。DB3502/T072已发布共安全视频图像系统运维管理平台建设的统一和规范，将进一步提升公共安全视频图像系统运维的服DB3502/T072拟由三个部分构成：——第1部分：总体要求。目的在于确立公共安全视件系统的组织形式，确保总体架构满足服务范围内公共安全视频图像系统运维需求，明确主——第2部分：接口。目的在于将公共安全视频图像系统运维管理平台对外接口标确接入的实现方式，为保障建设质量及拓展应用范围提供技术——第3部分：数据元。通过标准化描述公共安全视频图像系统运维管理平台型，构建标准化的数据环境，为建设数据共享、标准统一的公共安全视频图像运维管理1公共安全视频图像系统运维技术规范本文件适用于公共安全视频图像系统运维管理平台的规划设计、软件开发及接口协议的符合性测GB/T28181公共安全视频监控联网系统信息传输、交换、控制技术GA/T1400.4公安视频图像信息应用系统第4部分：接口协议要求DB3502/T072.1公共安全视频图像系统运维技术规范第1部分：总体要求IETFRFC2616超文本传输协议-HTTP/1.1（HypertextTransferGB/T28181、GA/T1400.4、DB3502/T072.1界定的术语和定义适用于本文4缩略语REST:表述性状态传递（RepresentationalStateTranSNMP:简单网络管理协议（SimpleNetworURI：统一资源标识符(UniformResourceIdentifi一机一档管理系统作为资源汇聚中心，提供统一运维对象开放接口，各类接口交互实体——运维系统对接接口用于公共安全视频图像系统运维管理平台和本级一机一档管理系统专业运维节点、下级公共安全视频图像系统运维管理平台、前端智能箱系统专业运维节点及2——统一运维对象开放接口用于一机一档管理系统和公共安全视频图像系统运维管理平台、前端智能箱系统专业运维节点及其他应用系统专业运维节点5.2协议结构——应用系统专业运维节点汇聚本系统相关的服务器、服务实例、子系统的异常告警及前端设备3——应用系统专业运维节点代理多个子系统时，各子系统对告警类型定义不完全一致情况下运维管理平台对接时，应用系统专业运维节点在保证告警码在系统内唯一的前提下，可上报6.2专用功能应用系统专业运维节点应支持服务实例维护，前端智能箱系统专业运维节点、专有设备管理可按需提供应用系统专业运维节点之间系统间告警订阅、和一机一档管理系统的设备信息进行比对分析，查找是否存在设应支持智能控制功能，对前端智能应支持向一机一档管理系统查询设8.1.1注册4a)应用系统专业运维节点向运维管理平台POST发送/nms/v1/re<b)运维管理平台将注册成功与否的响应返回给发起者。< 专业运维节点专业运维节点向运维管理平台发送/nms/v1/register进行注册专业运维节点注专业运维节点注注册失败注册处理注册失败注册处理5{}（R）id：一机一档管理系统分配应用系统（O）password：加密后的ID{}{}在过期时间之前调用方需要重新调用register接口获取新的toToken值放入后续请求header的authorization字段中标记已经登Authorization:Bearera.b.c8.1.2心跳a)应用系统专业运维节点定时向运维管理平台GET发送/nms/v1/heartbeab)运维管理平台将心跳成功与否的响应返回给发起者。6<< 败7无{}注：R为必选项，O<b)运维管理平台将操作成功与否的响应返回给发起者。<8/nms/v1/serviceInstance{9}{}—/nms/v1/serviceInstan{}—注：R为必选项，Oa)应用系统专业运维节点向运维管理平台发送/nms运维管理平台b)运维管理平台将操作成功与否的响应返回给发起者。运维管理平台专业运维节点 1POST/nms/v1/alarm< 2response<{"sourceId":"31010600"noticePerson":0,"attachment":"6Ieq5a6}{}—a)运维管理平台向应用系统专业运维节点发送/subsystem/v1/subsb)应用系统专业运维节点将操作成功与否的响应返回给运维管理平台。 < 2response<<>运维管理平台订阅应用系统专业运维节点状态，{"notifyURI":"http://i}{} 注：R为必选项，O状态订阅通知交互流程见图12，信令流程描b)运维管理平台将操作成功与否的响应返回给应用系统专业运维节点。 < <"notifyURI":"http://ip{}—a)应用系统专业运维节点向运维管理平台发送/nms/v1/subscirbe/alarb)运维系统将操作成功与否的响应返回给应用系统专业运维节点。 /nms/v1/subscirbe/alarm{"notifyURI":"http:/}{}—系统间告警订阅通知交互流程见图16，信令b)应用系统专业运维节点将操作成功与否的响应返回给运维管理平台。 1POST"notifyURI":< <向专业运维节点发送系统间告警订阅接口中notifyURI运维管理平台系统间告警通知异常处理处理失败运维管理平台系统间告警通知异常处理处理失败系统间告警订阅通知处理成功结束结束系统间告警订阅通知功能"notifyURI":"http://{"sourceId":"31010600"attachment":"6Ieq5a6{}—注：R为必选项，Oa)应用系统专业运维节点向运维管理平台发送/nms/v1/subscribe/statusb)运维管理平台将操作成功与否的响应返回给应用系统专业运维节点。 1POST/nms/v1/subsc< <<><>{"notifyUrl":"http:/}），{}—系统间状态订阅通知交互流程见图20，信令a)运维管理平台向应用系统发送应用系统专业运维节点自定义订阅通知请求；b)应用系统专业运维节点将操作成功与否的响应返回给运维管理平台。 1POST"notifyURI":< <向应用系统发送应用系统专业运维节点状态订阅接口中notifyURI定义的状态通知接口运维管理平台系统间状态通知异常处理处理失败处理成功专业运维节点接收系统间状态订运维管理平台系统间状态通知异常处理处理失败处理成功专业运维节点接收系统间状态订阅通知结束结束系统间状态订阅通知功能"notifyUrl":"http://{}—运维对象发现故障，通过工单方式上报运维管理平台，交互流程见图22，信令流程描述如下：a)应用系统专业运维节点向运维管理平台发工单报告；b)运维管理平台将操作成功与否的响应返回给应用系统专业运维节点。 < <{"sourceId":"3101060000"attachment":"6Ieq5a6}{}注：R为必选项，Ob)应用系统专业运维节点将操作成功与否的响应返回给运维管理平台。 < <<>"notifyUrl":"http://{}）；{}—注：R为必选项，O8.2前端智能箱系统对接接口a)运维管理平台向前端智能箱系统专业运维节点发送/subsystem/v1/device-l < </subsystem/v1/device-/subsystem/v1/device-list?page_num=1&page_siz无{"id":"c798deacbf82496d953"softwareVersion":""id":"e7ed2213017c4326be7}a)运维管理平台向前端智能箱系统专业运维节点发送/subsystem/v1/device/{id}请求；b)前端智能箱系统专业运维节点将操作成功与否的响应返回给运维管理平台。 1POST/subsystem/v1/device/{id}运维管理平台运维管理平台向前端智能箱系统专业运维节点发送/subsystem/v1/device/{id}运维管理平台前端智能箱控制异常处理前端智能箱系统专业运运维管理平台前端智能箱控制异常处理前端智能箱系统专业运维节点接收设备控制请求处理成功结束结束{}{}8.3统一运维对象开放接口a)应用系统向一机一档管理系统发送/kiop-gateway-core/现场网关/queryDeviceInfob)一机一档管理系统将操作成功与否的响应返回给应用系统。 1POST/kiop-gateway-core/现场< <向一机一档发送/kiop-gateway-core/现场网关/queryDeviceInfo应用系统进行设备应用系统进行设备信息查询异常处理处理失败一机一档接收查询设备信息请求处理失败一机一档接收查询设备信息请求处理成功结束结束/kiop-gateway-core/现场网关/queryDevic{}{"f_eq_deviceAttr.ipc.securityboxId":'db9b47bedab747c0a"f_in_civilCode":"3502"f_not_gbid"："350200000}(1)f_eq_deviceAttr.ipc.securityboxI……wheredeviceAttr.ipc.securityboxId='db9b47bedab747c0所属前端智能箱(deviceAttr.ipc.securityboxId)'db9b47bedab747c0a249c13a49420ae7'、设备名称（name“35020000001370000218”、经度（longitude）不为空、纬度（latitude）{}}放在deviceAttr中的为设备私有属性，ipc为网络摄像机（视图传感器）的设备类型标识状态结果通知交互流程见图32，信令流程描b)应用系统将操作成功与否的响应返回给一机一档管理系统。应用系统应用系统一机一档 1POSThttp://ip:port/xxxxx< 2response<{"id":"fcf9e2f27e8d4defa3a"gbid":"1000000103}{}REST是一种通过采用统一方式将所有信息抽象为资源来创建服务的方法，任何能够被命名的信息之间传递该表述，一