DB3502∕T 072.2-2021 公共安全視頻圖像系統(tǒng)運維技術規(guī)范 第2部分：接口　　

3502Technicalspecificationforoperationandmaintenanceofvideoandimagesystemforpublicsecurity—Part2:InterfacesI 2 3 3 本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定本文件為DB3502/T072《公共安全視頻圖像系統(tǒng)運維技術規(guī)范》的第2部分。DB3502/T072已發(fā)布共安全視頻圖像系統(tǒng)運維管理平臺建設的統(tǒng)一和規(guī)范，將進一步提升公共安全視頻圖像系統(tǒng)運維的服DB3502/T072擬由三個部分構成：——第1部分：總體要求。目的在于確立公共安全視件系統(tǒng)的組織形式，確?？傮w架構滿足服務范圍內公共安全視頻圖像系統(tǒng)運維需求，明確主——第2部分：接口。目的在于將公共安全視頻圖像系統(tǒng)運維管理平臺對外接口標確接入的實現(xiàn)方式，為保障建設質量及拓展應用范圍提供技術——第3部分：數(shù)據(jù)元。通過標準化描述公共安全視頻圖像系統(tǒng)運維管理平臺型，構建標準化的數(shù)據(jù)環(huán)境，為建設數(shù)據(jù)共享、標準統(tǒng)一的公共安全視頻圖像運維管理1公共安全視頻圖像系統(tǒng)運維技術規(guī)范本文件適用于公共安全視頻圖像系統(tǒng)運維管理平臺的規(guī)劃設計、軟件開發(fā)及接口協(xié)議的符合性測GB/T28181公共安全視頻監(jiān)控聯(lián)網系統(tǒng)信息傳輸、交換、控制技術GA/T1400.4公安視頻圖像信息應用系統(tǒng)第4部分：接口協(xié)議要求DB3502/T072.1公共安全視頻圖像系統(tǒng)運維技術規(guī)范第1部分：總體要求IETFRFC2616超文本傳輸協(xié)議-HTTP/1.1（HypertextTransferGB/T28181、GA/T1400.4、DB3502/T072.1界定的術語和定義適用于本文4縮略語REST:表述性狀態(tài)傳遞（RepresentationalStateTranSNMP:簡單網絡管理協(xié)議（SimpleNetworURI：統(tǒng)一資源標識符(UniformResourceIdentifi一機一檔管理系統(tǒng)作為資源匯聚中心，提供統(tǒng)一運維對象開放接口，各類接口交互實體——運維系統(tǒng)對接接口用于公共安全視頻圖像系統(tǒng)運維管理平臺和本級一機一檔管理系統(tǒng)專業(yè)運維節(jié)點、下級公共安全視頻圖像系統(tǒng)運維管理平臺、前端智能箱系統(tǒng)專業(yè)運維節(jié)點及2——統(tǒng)一運維對象開放接口用于一機一檔管理系統(tǒng)和公共安全視頻圖像系統(tǒng)運維管理平臺、前端智能箱系統(tǒng)專業(yè)運維節(jié)點及其他應用系統(tǒng)專業(yè)運維節(jié)點5.2協(xié)議結構——應用系統(tǒng)專業(yè)運維節(jié)點匯聚本系統(tǒng)相關的服務器、服務實例、子系統(tǒng)的異常告警及前端設備3——應用系統(tǒng)專業(yè)運維節(jié)點代理多個子系統(tǒng)時，各子系統(tǒng)對告警類型定義不完全一致情況下運維管理平臺對接時，應用系統(tǒng)專業(yè)運維節(jié)點在保證告警碼在系統(tǒng)內唯一的前提下，可上報6.2專用功能應用系統(tǒng)專業(yè)運維節(jié)點應支持服務實例維護，前端智能箱系統(tǒng)專業(yè)運維節(jié)點、專有設備管理可按需提供應用系統(tǒng)專業(yè)運維節(jié)點之間系統(tǒng)間告警訂閱、和一機一檔管理系統(tǒng)的設備信息進行比對分析，查找是否存在設應支持智能控制功能，對前端智能應支持向一機一檔管理系統(tǒng)查詢設8.1.1注冊4a)應用系統(tǒng)專業(yè)運維節(jié)點向運維管理平臺POST發(fā)送/nms/v1/re<b)運維管理平臺將注冊成功與否的響應返回給發(fā)起者。< 專業(yè)運維節(jié)點專業(yè)運維節(jié)點向運維管理平臺發(fā)送/nms/v1/register進行注冊專業(yè)運維節(jié)點注專業(yè)運維節(jié)點注注冊失敗注冊處理注冊失敗注冊處理5{}（R）id：一機一檔管理系統(tǒng)分配應用系統(tǒng)（O）password：加密后的ID{}{}在過期時間之前調用方需要重新調用register接口獲取新的toToken值放入后續(xù)請求header的authorization字段中標記已經登Authorization:Bearera.b.c8.1.2心跳a)應用系統(tǒng)專業(yè)運維節(jié)點定時向運維管理平臺GET發(fā)送/nms/v1/heartbeab)運維管理平臺將心跳成功與否的響應返回給發(fā)起者。6<< 敗7無{}注：R為必選項，O<b)運維管理平臺將操作成功與否的響應返回給發(fā)起者。<8/nms/v1/serviceInstance{9}{}—/nms/v1/serviceInstan{}—注：R為必選項，Oa)應用系統(tǒng)專業(yè)運維節(jié)點向運維管理平臺發(fā)送/nms運維管理平臺b)運維管理平臺將操作成功與否的響應返回給發(fā)起者。運維管理平臺專業(yè)運維節(jié)點 1POST/nms/v1/alarm< 2response<{"sourceId":"31010600"noticePerson":0,"attachment":"6Ieq5a6}{}—a)運維管理平臺向應用系統(tǒng)專業(yè)運維節(jié)點發(fā)送/subsystem/v1/subsb)應用系統(tǒng)專業(yè)運維節(jié)點將操作成功與否的響應返回給運維管理平臺。 < 2response<<>運維管理平臺訂閱應用系統(tǒng)專業(yè)運維節(jié)點狀態(tài)，{"notifyURI":"http://i}{} 注：R為必選項，O狀態(tài)訂閱通知交互流程見圖12，信令流程描b)運維管理平臺將操作成功與否的響應返回給應用系統(tǒng)專業(yè)運維節(jié)點。 < <"notifyURI":"http://ip{}—a)應用系統(tǒng)專業(yè)運維節(jié)點向運維管理平臺發(fā)送/nms/v1/subscirbe/alarb)運維系統(tǒng)將操作成功與否的響應返回給應用系統(tǒng)專業(yè)運維節(jié)點。 /nms/v1/subscirbe/alarm{"notifyURI":"http:/}{}—系統(tǒng)間告警訂閱通知交互流程見圖16，信令b)應用系統(tǒng)專業(yè)運維節(jié)點將操作成功與否的響應返回給運維管理平臺。 1POST"notifyURI":< <向專業(yè)運維節(jié)點發(fā)送系統(tǒng)間告警訂閱接口中notifyURI運維管理平臺系統(tǒng)間告警通知異常處理處理失敗運維管理平臺系統(tǒng)間告警通知異常處理處理失敗系統(tǒng)間告警訂閱通知處理成功結束結束系統(tǒng)間告警訂閱通知功能"notifyURI":"http://{"sourceId":"31010600"attachment":"6Ieq5a6{}—注：R為必選項，Oa)應用系統(tǒng)專業(yè)運維節(jié)點向運維管理平臺發(fā)送/nms/v1/subscribe/statusb)運維管理平臺將操作成功與否的響應返回給應用系統(tǒng)專業(yè)運維節(jié)點。 1POST/nms/v1/subsc< <<><>{"notifyUrl":"http:/}），{}—系統(tǒng)間狀態(tài)訂閱通知交互流程見圖20，信令a)運維管理平臺向應用系統(tǒng)發(fā)送應用系統(tǒng)專業(yè)運維節(jié)點自定義訂閱通知請求；b)應用系統(tǒng)專業(yè)運維節(jié)點將操作成功與否的響應返回給運維管理平臺。 1POST"notifyURI":< <向應用系統(tǒng)發(fā)送應用系統(tǒng)專業(yè)運維節(jié)點狀態(tài)訂閱接口中notifyURI定義的狀態(tài)通知接口運維管理平臺系統(tǒng)間狀態(tài)通知異常處理處理失敗處理成功專業(yè)運維節(jié)點接收系統(tǒng)間狀態(tài)訂運維管理平臺系統(tǒng)間狀態(tài)通知異常處理處理失敗處理成功專業(yè)運維節(jié)點接收系統(tǒng)間狀態(tài)訂閱通知結束結束系統(tǒng)間狀態(tài)訂閱通知功能"notifyUrl":"http://{}—運維對象發(fā)現(xiàn)故障，通過工單方式上報運維管理平臺，交互流程見圖22，信令流程描述如下：a)應用系統(tǒng)專業(yè)運維節(jié)點向運維管理平臺發(fā)工單報告；b)運維管理平臺將操作成功與否的響應返回給應用系統(tǒng)專業(yè)運維節(jié)點。 < <{"sourceId":"3101060000"attachment":"6Ieq5a6}{}注：R為必選項，Ob)應用系統(tǒng)專業(yè)運維節(jié)點將操作成功與否的響應返回給運維管理平臺。 < <<>"notifyUrl":"http://{}）；{}—注：R為必選項，O8.2前端智能箱系統(tǒng)對接接口a)運維管理平臺向前端智能箱系統(tǒng)專業(yè)運維節(jié)點發(fā)送/subsystem/v1/device-l < </subsystem/v1/device-/subsystem/v1/device-list?page_num=1&page_siz無{"id":"c798deacbf82496d953"softwareVersion":""id":"e7ed2213017c4326be7}a)運維管理平臺向前端智能箱系統(tǒng)專業(yè)運維節(jié)點發(fā)送/subsystem/v1/device/{id}請求；b)前端智能箱系統(tǒng)專業(yè)運維節(jié)點將操作成功與否的響應返回給運維管理平臺。 1POST/subsystem/v1/device/{id}運維管理平臺運維管理平臺向前端智能箱系統(tǒng)專業(yè)運維節(jié)點發(fā)送/subsystem/v1/device/{id}運維管理平臺前端智能箱控制異常處理前端智能箱系統(tǒng)專業(yè)運運維管理平臺前端智能箱控制異常處理前端智能箱系統(tǒng)專業(yè)運維節(jié)點接收設備控制請求處理成功結束結束{}{}8.3統(tǒng)一運維對象開放接口a)應用系統(tǒng)向一機一檔管理系統(tǒng)發(fā)送/kiop-gateway-core/現(xiàn)場網關/queryDeviceInfob)一機一檔管理系統(tǒng)將操作成功與否的響應返回給應用系統(tǒng)。 1POST/kiop-gateway-core/現(xiàn)場< <向一機一檔發(fā)送/kiop-gateway-core/現(xiàn)場網關/queryDeviceInfo應用系統(tǒng)進行設備應用系統(tǒng)進行設備信息查詢異常處理處理失敗一機一檔接收查詢設備信息請求處理失敗一機一檔接收查詢設備信息請求處理成功結束結束/kiop-gateway-core/現(xiàn)場網關/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為網絡攝像機（視圖傳感器）的設備類型標識狀態(tài)結果通知交互流程見圖32，信令流程描b)應用系統(tǒng)將操作成功與否的響應返回給一機一檔管理系統(tǒng)。應用系統(tǒng)應用系統(tǒng)一機一檔 1POSThttp://ip:port/xxxxx< 2response<{"id":"fcf9e2f27e8d4defa3a"gbid":"1000000103}{}REST是一種通過采用統(tǒng)一方式將所有信息抽象為資源來創(chuàng)建服務的方法，任何能夠被命名的信息之間傳遞該表述，一