消防物聯網系統對接技術規范目 次前言 II112范引文件 13語定義 14略語 25統接型 25.1組部分 25.2對功能 36本求 36.1功要求 36.2安要求 46.3數傳時要求 46.4接要求 57口現 57.1數查詢 57.2數推送 117.3消視調用 23附錄A（范）平聯網息互程 26附錄B（范）數元描述 30附錄C（料）REST架構議型 58附錄D（料）接消息范 62附錄規性服務構一碼則 64附錄F（范）數字典 65參考獻 77I消防物聯網系統對接技術規范范圍本標準規定了消防物聯網系統數據對接的系統對接模型、基本要求和接口實現。本標準適用于消防物聯網系統數據交互過程中接口協議的設計開發、運行管理和應用。（GB/T2260中華人民共和國行政區劃代碼GB/T4754—2017國民經濟行業分類GB/T10114縣級以下行政區劃代碼編制規則GB11643公民身份號碼GB26875（所有部分）城市消防遠程監控系統GB/T28181—2016公共安全視頻監控聯網系統信息傳輸、交換、控制技術要求GB32100—2015法人和其他組織統一社會信用代碼編碼規則GB50440DB33/T2349DB33/T2351ISO8601IETFRFC2616超文本傳輸協議-HTTP/1.1(HypertextTransferProtocol-HTTP/1.1)GB26875（所有部分）和GB50440界定的以及下列術語和定義適用于本標準。3.1消防聯系統 iotsystemforfire利用物聯網技術采集消防相關的物、人、系統和信息資源，并進行處理的系統。3.2消防聯運服機構 theoperationserviceagencyoffireiot利用物聯網技術開展社會化消防運營服務的企事業單位。3.3聯網位 networkedunit將火災預警信息、事件預警信息和故障信息，以及物聯設備運行狀態傳送到消防物聯網運營服務平臺，并能接收消防物聯網運營服務平臺發送的相關信息的單位。1縮略語（AccessKey）AES：密碼學中的高級加密標準（AadvancedEncryptionStandard）ECDH：一種基于橢圓曲線的密鑰協商算法HTTP：超文本傳輸協議（HyperTextTransferProtocol）HTTPS：超文本傳輸安全協議（HyperTextTransferProtocolOverSecureSocketLayer）IP：國際互聯協議（InternetProtocol）JS：一種具有函數優先的輕量級，解釋型或即時編譯型的編程語言（JavaScript）JSON：JavaScript對象標記語言（JavaScriptObjectNotation）REST：表述性狀態傳遞（RepresentationalStateTransfer）SK：密鑰（SecretKey）TLS：傳輸層安全性協議（TransportLayerSecurity）URI：全局資源標識符（UniversalResourceIdentifier）URL：統一資源定位符（UniformResoureLocator）UTF-8：可變長度字符編碼（8-bitUnicodeTransformationForma）2下級系統基礎資源數據消防物聯感知數據聯網單位信息住宅小區信息建筑物信息監控數據信息火災預警信息重點部位信息物聯設備信息運營機構信息事件預警信息故障信息部件信息運營機構人員信息消防視頻流運行狀態物聯處置數據運營機構管理數據火災預警處置信息事件預警處置信息故障處置信息運營機構值班記錄運營機構維保記錄基于REST的HTTP/HTTPS協議上級系統數據推送接口數據查詢接口圖1 系統對模圖基于REST的HTTP/HTTPS協議上級系統數據推送接口數據查詢接口RESTHTTP/HTTPS5.13基礎資源數據查詢對應接口實現應符合7.1中的相關規定。消防基礎資源數據上報對應接口說明應符合7.2中的相關規定。5消防安全視頻調用對應接口說明應符合7.3中的相關規定。上級系統審核通過后，向下級系統發放身份憑證。上級系統和下級系統之間相互訪問。基于HTTP/HTTPS時應采用符合附錄A中加密的安全摘要認證方式，算法使用加密安全哈希算法HMAC-SHA256，平臺提供身份憑證，獲取身份密鑰（AK、SK）。L2L2HTTPSTLSV1.2TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA256，TLS_EDHERSAWIT_AE128_GM_SA25X.5上級系統與下級系統傳輸公共數據應符合DB33/T2349和DB33/T2351。15500101010104105協議參見附錄CREST，接口相對URL符合fire/*或fire/*/*。接口消息描述定義見附錄D中D.1接口消息描述。接口數據信息中運營服務機構唯一編碼應符合附錄E中運營服務機構唯一編碼規則的規定。上級系統主動向下級系統發起數據查詢請求，下級系統按請求返回數據，具體流程應與圖2相符合。AK、SK生成字符串TokenA，傳入查詢參 請求頭部帶上認證字符串驗證認根據查詢參數獲取查詢涉及隱私則加密）返回查詢數據 查詢失敗，身份認證未通過請求身份認證失敗數據身份認證成功下級系統上級系統圖2 數據詢程5生成認證字符串和驗證認證字符串應符合附錄A的A.1中的相關規定。的A.2上級系統向下級系統查詢數據，通用查詢請求頭參數應符合表1和通用查詢請求參數應符合表2。表1 通用詢求參數名稱數據類型是否必填默認值說明Client-TokenStringM(無)客戶端請求認證字符串注：M為必填。表2 通用詢求數名稱數據類型是否必填默認值說明startDateStringO(無)起始日期，應符合ISO8601標準endDateStringO當前日期截止日期，應符合ISO8601標準pageSizeIntegerM1000據結果大于一頁時，需要多次請求獲取。0＜pageSize≤1000pageNoIntegerM(無)頁面序號，pageNo＞0注：M為必填，O為非必填。上級系統向下級系統查詢數據，通用查詢響應頭參數應符合表3和通用查詢返回參數應符合表4。表3 通用詢應參數名稱數據類型是否必填默認值說明Server-TokenStringM(無)服務響應認證字符串注：M為必填。表4 通用詢回數名稱數據類型說明codeString返回碼，0表示成功，其他值應符合附錄F的F.1錯誤碼messageString接口執行情況說明信息dataObject返回值對象上級系統向下級系統查詢聯網單位數據,應符合表5～表6。表5 聯網位詢口接口描述查詢與校正數據相對URLfire/company/dataRows方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.1.2的相關規定，返回參數data字段應符合表6。表6 返回數data字段名稱數據類型說明rowCountInteger返回記錄數pageCountInteger返回頁面總數(與請求參數單頁數量計算獲得)listsObject[]數據行數組，元素是聯網單位信息（company），應符合附錄B的B.1。上級系統向下級系統查詢住宅小區數據，應符合表7～表8。表7 住宅區詢口接口描述查詢與校正數據相對URLfire/community/dataRows方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.1.2中的相關規定，返回參數data字段應符合表8。表8 返回數data字段名稱數據類型說明rowCountInteger返回記錄數pageCountInteger返回頁面總數(與請求參數單頁數量計算獲得)listsObject[]數據行數組，元素是住宅小區信息（community），應符合附錄B的B.2上級系統向下級系統查詢建筑物數據，應符合表9～表10。表9 建筑查接口接口描述查詢與校正數據相對URLfire/building/dataRows方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.1.2的相關規定，返回參數data字段應符合表10。表10 返回數data字段名稱數據類型說明rowCountInteger返回記錄數pageCountInteger返回頁面總數(與請求參數單頁數量計算獲得)listsObject[]數據行數組，元素是建筑物信息（building），應符合附錄B的B.3上級系統向下級系統查詢重點部位數據，應符合表11～表12。表11 重點位詢口接口描述查詢與校正數據相對URLfire/importantposition/dataRows方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.1.2的相關規定，返回參數data字段應符合表12。表12 返回數data字段名稱數據類型說明rowCountInteger返回記錄數pageCountInteger返回頁面總數(與請求參數單頁數量計算獲得)listsObject[]數據行數組，元素是重點部位數據，應符合附錄B的B.4。上級系統向下級系統查詢物聯設備數據，應符合表13～表14。表13 物聯備詢口接口描述查詢與校正數據相對URLfire/firedevice/dataRows方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.1.2的相關規定，返回參數data字段應符合表14。表14 返回數data字段名稱數據類型說明rowCountInteger返回記錄數pageCountInteger返回頁面總數(與請求參數單頁數量計算獲得)listsObject[]數據行數組，元素是物聯設備信息（fireDevice），應符合附錄B的B.5上級系統向下級系統查詢部件數據，應符合表15～表16。表15 部件詢口接口描述查詢與校正數據相對URLfire/part/dataRows方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.1.2的相關規定，返回參數data字段應符合表16。表16 返回數date字段名稱數據類型說明rowCountInteger返回記錄數pageCountInteger返回頁面總數(與請求參數單頁數量計算獲得)listsObject[]數據行數組，元素是部件信息（sensor），應符合附錄B的B.6上級系統向下級系統查詢消防物聯網運營服務機構數據，應符合表17～表18。表17 運營構詢口接口描述查詢與校正數據相對URLfire/servicecompany/dataRows方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.1.2的相關規定，返回參數data字段應符合表18。9表18 返回數data字段名稱數據類型說明rowCountInteger返回記錄數pageCountInteger返回頁面總數(與請求參數單頁數量計算獲得)listsObject[]（serviceagency），應符合附錄B的B.7上級系統向下級系統查詢運營服務機構人員數據，應符合表19～表20。表19 運營構員詢口接口描述查詢與校正數據相對URLfire/person/dataRows方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭和返回參數應符合7.1.2中的相關規定，返回參數data字段應符合表20。表20 返回數data字段名稱數據類型說明rowCountInteger返回記錄數pageCountInteger返回頁面總數(與請求參數單頁數量計算獲得)listsObject[]數據行數組，元素是運營服務機構人員信息（person），應符合附錄B的B.8上級系統向下級系統查詢運營機構維保記錄數據，應符合表21～表22。表21 運營構保錄詢口接口描述查詢與校正數據相對URLfire/maintenance/dataRows方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.1.2中的相關規定，返回參數data字段應符合表22。表22 返回數data字段名稱數據類型說明rowCountInteger返回記錄數pageCountInteger返回頁面總數(與請求參數單頁數量計算獲得)listsObject[]應符合附錄B的B.17上級系統向下級系統查詢運營機構值班記錄數據，應符合表23～表24。表23 運營構班錄詢口接口描述查詢與校正數據相對URLfire/dutyshift/dataRows方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.1.2中的相關規定，返回參數data字段應符合表24。表24 返回數data字段名稱數據類型說明rowCountInteger返回記錄數pageCountInteger返回頁面總數(與請求參數單頁數量計算獲得)listsObject[]數據行數組，元素是運營機構值班記錄信息（dutyShift），應符合附錄B的B.18當下級系統出現數據增加、修改、刪除情況時，下級系統通過http接口實時向上級系統上報數據。具體流程應符合圖3。11使用AK、SK、加密后數據使用AK、SK、加密后數據生成認證字符串POST請求數據上報接口，攜帶加密后數據請求頭部帶上認證字符串驗證認響應上報成功使用密鑰解密以及協商的加密算法解密被加密的數據上報失敗，身份認證未通過請求身份認證失敗請求身份認證成功證字符串上級系統下級系統圖3 數據報程生成認證字符串和驗證認證字符串應符合附錄A的A.1中的相關規定。的A.22526。表25 通用送求參數名稱數據類型是否必填默認值說明Client-TokenStringM(無)客戶端請求認證字符串注：M為必填。12表26 通用送求數名稱數據類型是否必填默認值說明opt_typeIntegerM00-新增或修改，1-刪除listsObject[]M(無)列表數據信息應合附錄B，刪除時只需填對應的數據id和parent_id注：M為必填。2728～29表27 通用送應參數名稱數據類型是否必填默認值說明Server-TokenStringM(無)服務響應認證字符串注：M為必填。表28 通用送回數名稱數據類型說明codeString返回碼，0表示成功，其他值應符合附錄F的F.1錯誤碼messageString接口執行情況說明信息dataObject返回值對象，內含successesfailures表29 返回數data字段名稱數據類型說明successesObject[]對象數組類型，表示添加成功數據列表failuresObject[]對象數據類型，表示添加失敗數據列表下級系統新建、修改、刪除聯網單位后，將變更信息上報至上級系統，應符合表30～表32。表30 聯網位送口接口描述推送與校正數據相對URLfire/company/update方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表31，返回參數failures字段應符合表32。表31 successes字信息名稱數據類型說明company_idString聯網單位唯一編碼表32 failures字信息名稱數據類型說明company_idString聯網單位唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統新建、修改、刪除住宅小區后，將變更信息上報至上級系統，應符合表33～表35。表33 住宅區送口接口描述推送與校正數據相對URLfire/community/update方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表34，返回參數failures字段應符合表35。表34 successes字信息名稱數據類型說明community_idString住宅小區唯一編碼表35 failures字信息名稱數據類型說明community_idString住宅小區唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統新建、修改、刪除建筑物后，將變更信息上報至上級系統，應符合表36～表38。表36 建筑推接口接口描述推送與校正數據相對URLfire/building/update方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表37，返回參數failures字段應符合表38。表37 successes字信息名稱數據類型說明building_idString建筑物唯一編碼表38 failures字信息名稱數據類型說明building_idString建筑物唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統新建、修改、刪除重點部位后，將變更信息上報至上級系統，應符合表39～表41。表39 重點位送口接口描述推送與校正數據相對URLfire/importantposition/update方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表40，返回參數failures字段應符合表41。表40 successes字信息名稱數據類型說明importantposition_idString重點部位唯一編碼表41 failures字信息名稱數據類型說明importantposition_idString重點部位唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統新建、修改、刪除物聯設備后，將變更信息上報至上級系統，應符合表42～表44。表42 物聯備送口接口描述推送與校正數據相對URLfire/device/update方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表43，返回參數failures字段應符合表44。表43 successes字信息名稱數據類型說明device_idString物聯設備唯一編碼表44 failures字信息名稱數據類型說明device_idString物聯設備唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統新建、修改、刪除部件后，將變更信息上報至上級系統，應符合表45～表47。表45 部件送口接口描述推送與校正數據相對URLfire/part/update方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表46，返回參數failures字段應符合表47。表46 successes字信息名稱數據類型說明part_idString部件唯一編碼表47 failures字信息名稱數據類型說明part_idString部件唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息上級系統新建、修改、刪除運營機構信息后，將變更信息上報至下級系統，應符合表48～表50。表48 運營構送口接口描述推送與校正數據相對URLfire/servicecompany/update方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表49，返回參數failures字段應符合表50。表49 successes字信息名稱數據類型說明parent_idString消防物聯網運營服務機構唯一編碼表50 failures字信息名稱數據類型說明parent_idString消防物聯網運營服務機構唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統新建、修改、刪除運營機構人員后，將變更信息上報至上級系統，應符合表51～表53。表51 運營構員送口接口描述推送與校正數據相對URLfire/person/update方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表52，返回參數failures字段應符合表53。表52 successes字信息名稱數據類型說明person_idString運營服務機構人員唯一編碼表53 failures字信息名稱數據類型說明person_idString運營服務機構人員唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統的物聯設備運行狀態實時上報至上級系統，應符合表54～表56。表54 物聯備行態送口接口描述推送與校正數據相對URLfire/devicestate/report方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表55，返回參數failures字段應符合表56。表55 successes字信息名稱數據類型說明event_idString事件唯一編碼表56 failures字信息名稱數據類型說明event_idString事件唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統的監測數據實時上報至上級系統，應符合表57～表59。 表57 監測據送口接口描述推送與校正數據相對URLfire/monitor/report方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表58，返回參數failures字段應符合表59。表58 successes字信息名稱數據類型說明event_idString事件唯一編碼表59 failures字信息名稱數據類型說明event_idString事件唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統的故障信息實時上報至上級系統，應符合表60～表62。表60 故障息送口接口描述推送與校正數據相對URLfire/fault/report方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表61，返回參數failures字段應符合表62。表61 successes字信息名稱數據類型說明event_idString事件唯一編碼表62 failures字信息名稱數據類型說明event_idString事件唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統的事件預警信息實時上報至上級系統，應符合表63～表65。表63 事件警息送口接口描述推送與校正數據相對URLfire/warning/report方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表64，返回參數failures字段應符合表65。表64 successes字信息名稱數據類型說明event_idString事件唯一編碼表65 failures字信息名稱數據類型說明event_idString事件唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統的火災預警信息實時上報至上級系統，應符合表66～表68。表66 火災警息送口接口描述推送與校正數據相對URLfire/firealarm/report方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表67，返回參數failures字段應符合表68。表67 successes字信息名稱數據類型說明event_idString事件唯一編碼表68 failures字信息名稱數據類型說明event_idString事件唯一編碼表68 failures字信（續）名稱數據類型說明codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統的故障處置信息實時上報至上級系統，應符合表69～表71。表69 故障置息送口接口描述推送與校正數據相對URLfire/faultprocess/report方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表70，返回參數failures字段應符合表71。表70 successes字信息名稱數據類型說明event_idString事件唯一編碼表71 failures字信息名稱數據類型說明event_idString事件唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統的事件預警處置信息實時上報至上級系統，應符合表72～表74。表72 事件警置息送口接口描述推送與校正數據相對URLfire/warningprocess/report方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表73，返回參數failures字段應符合表74。 表73 successes段息名稱數據類型說明event_idString事件唯一編碼表74 failures字信息名稱數據類型說明event_idString事件唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統的火災預警處置信息實時上報至上級系統，應符合表75～表77。表75 火災警置息送口接口描述推送與校正數據相對URLfire/firealarmprocess/report方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表76，返回參數failures字段應符合表77。表76 successes字信息名稱數據類型說明event_idString事件唯一編碼表77 failures字信息名稱數據類型說明event_idString事件唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統的運營機構維保記錄實時上報至上級系統，應符合表78～表80。表78 運營構保錄送口接口描述推送與校正數據相對URLfire/maintenancerecord/report方法POST表78 運機維記推送口續）接口描述推送與校正數據數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表79，返回參數failures字段應符合表80。表79 successes字信息名稱數據類型說明record_idString記錄唯一編碼表80 failures字信息名稱數據類型說明record_idString記錄唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息下級系統的運營機構值班記錄實時上報至上級系統，應符合表81～表83。表81 運營構班錄送口接口描述推送與校正數據相對URLfire/dutyrecord/report方法POST數據提交方式（Content-Type）application/json請求頭參數和請求參數、響應頭參數和返回參數應符合7.2.2中的相關規定，返回參數successes字段應符合表82，返回參數failures字段應符合表83。表82 successes字信息名稱數據類型說明record_idString記錄唯一編碼表83 failures字信息名稱數據類型說明record_idString記錄唯一編碼codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼messageString錯誤信息上級系統向下級系統調用視頻的步驟如下：7.3.24使用AK、SK、查詢參數生成字符串TokenA請求頭部帶上認證字符串驗證認根據查詢參數獲取查詢涉及隱私則加密）返回查詢數據 查詢失敗，身份認證未通過請求身份認證失敗數據請求身份認證成功下級系統上級系統圖4 視頻用程圖H5JS7.3.1a）URLURL84～表87表84 視頻放址詢口接口描述查詢與校正數據相對URLfire/playurl方法POST數據提交方式（Content-Type）application/json表85 請求數名稱數據類型是否必填默認值說明part_idStringM(無)通常指監控點的編號注：M為必填。表86 返回數名稱數據類型說明codeString返回碼，0表示成功，其他值應符合附錄F的F.1錯誤碼messageString接口執行情況說明信息dataObject返回值對象表87 返回數data字段名稱數據類型說明play_urlString用于播放視頻的地址附錄A（規范性）平臺聯網消息交互流程HMAC-SHA256請求者身份認證）帶上請求參數，并在HTTP請求頭設置User-Identify屬性及其值）；3.2如果不一致，則身份認證失敗）SK)提供者的AK+：+有效期時間戳))返回數據，并在HTTP響應頭設置Server-Identify屬性及其值、）；敗字符串的公式生成認證摘要字符有效期時間和認證摘要字符串；服務提供者身份認證服務提供者請求者

圖A.1基于HMAC-SHA256的摘要認證流程認證流程補充說明如下：SKHMAC-SHA256AKHTTPClient-TokenBASE64（字符串拼接（認證摘要字符串+“：”+請求者的AK+“：”+認證摘要字符串的有效期時間戳））；HTTPServer-TokenBASE64（字符串拼接（認證摘要字符串+“：”+服務提供方的AK+“：”+認證摘要字符串的有效期時間戳））。數據在網絡傳輸過程中使用高級加密標準（AES）算法進行加密、解密，雙方使用ECDH算法協商密鑰。HTTPS的密鑰協商及傳輸加解密，已經由協議標準的網絡庫協議棧和加密套件實現，此流程主要表述HTTP協議的密鑰協商流程。HTTP協議下使用ECDH算法進行密鑰協商流程應與圖A.2相符合。下系統 上系統生成ECDH協商信息（公鑰A、私鑰A）SK)AK+：+有效期時間戳))

傳入公鑰A、算法列表、會話IDhttp頭部帶上認證字符串從請求頭獲取認證字符串，解析出會話ID、公鑰A、數據加密列表、AK、有效期時間錯，計算出簽名摘要，餅比較驗證請求者身份以及請求有效期生成ECDH協商信息（公鑰B、私鑰B），從算法列表中挑選一個加密算法，使用上級系統AK、SK，與會話ID、加密算法、公鑰B、密鑰過期時間，生成響應認證字符串TokenB

使用ECDH（公鑰B、私鑰B、公鑰A）生成密鑰

身份驗證失敗圖A.2HTTP協議下使用ECDH算法進行密鑰協商流程流程描述如下：ECDHAISKHM-SH26（AK）、會話IDTokenAKBASE64Token，tokenToken），SK））；（AK，IDA）；TokenBASE64（AK））；TokenAK用這個AK找到SK；根據此服務接口的摘要參數約定的順序，拼接參數字符串，并利用HMAC-SHA256TokenBTokenTokenB，如果完全一致，則數據未被修改，并且身份認證通過，并且如果時間戳在有效時間范圍內則ECDHBBECDHA、公鑰B、私鑰BAK、SKIDECDH）證字符串TokenB，生成公式及算法與請求一致；并在響應頭追加resptoken屬性頭及其值TokenBIDBresptokenECDHAB附錄B（規范性）數據元描述（company）聯網單位應符合表B.1。表B.1聯網單位表中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明聯網單位編碼company_idString32M無條件共享無條件開放L1消防物聯網運營服務機構自定義聯網單位名稱company_nameString32M無條件共享無條件開放L1聯網單位營業執照名稱運營服務機構唯一編碼parent_idString32M無條件共享無條件開放L1應符合附錄的相關規定統一社會信用代碼company_codeString32M無條件共享無條件開放L1應符合32100網單位的統一單位地址addressString64M無條件共享無條件開放L1行政區劃+鄉鎮街道+門牌號+小區(組)+樓牌號+單元號+戶室行政區域編碼region_codeString16M無條件共享無條件開放L1應符合2260和10114的規定(可參考國家統計局統計用區劃和城鄉劃分代碼，填寫編碼需至村社級12位的行政區域代碼)單位類別company_categoryString16M無條件共享無條件開放L1消防列管單位類別，應符合附錄F.11單位類別表B.1聯網單位表（續）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明單位類型company_typeInteger3M無條件共享無條件開放L1應符合附錄F的F.2行業類型industry_typeString16M無條件共享無條件開放L1應符合GB/T4754—2017表1寫代碼為門類務代碼)消防安全管理人姓名fire_managerString16M無條件共享無條件開放L1消防管理人名稱消防安全管理人聯系電話fire_manager_telString16M無條件共享無條件開放L1消防管理人手機號碼消防安全責任人姓名fire_liableString16M無條件共享無條件開放L1消防責任人名稱消防安全責任人聯系電話fire_liable_telString16M無條件共享無條件開放L1消防責任人手機號碼消控室電話fireroom_numberString16O無條件共享無條件開放L1職工總人數employee_countInteger8O無條件共享無條件開放L1成立時間company_founding_timeString16O無條件共享無條件開放L1應符合ISO8601yyyy-MM-ddHH:mm:ss上級主管單位名稱parent_company_nameString16O無條件共享無條件開放L1管轄單位名稱firemanagementString32O無條件共享無條件開放L1隸屬于具體的區縣消防救援大隊經濟所有制economicownershipString16O無條件共享無條件開放L1應符合GB/T12402的規定固定資產fixedassetsString16O無條件共享無條件開放L1單位：萬元，精確到小數點2位31表B.1聯網單位表（續）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明單位占地面積occaupy_areaString16O無條件共享無條件開放L1單位：㎡總建筑面積build_areaString16O無條件共享無條件開放L1單位：㎡地圖類型map_typeInteger3C無條件共享無條件開放L1應符合附錄F的F.3(若填寫經緯度，地圖類型必填)經度lngString16O無條件共享無條件開放L1精確到小數點后7位緯度latString16O無條件共享無條件開放L1精確到小數點后7位創建時間create_timeString16M無條件共享無條件開放L1應符合8601yyyy-MM-ddHH:mm:ss修改時間update_timeString16M無條件共享無條件開放L1應符合8601yyyy-MM-ddHH:mm:ss注：M為必填，O為非必填，C符合說明中條件必填。（community）住宅小區應符合表B.2。表B.2住宅小區表中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明住宅小區編碼community_idString32M無條件共享無條件開放L1消防物聯網運營服務機構自定義住宅小區名稱community_nameString16M無條件共享無條件開放L1消防物聯網運營服務機構自定義運營服務機構唯一編碼編碼parent_idString32M無條件共享無條件開放L1應符合附錄E的相關規定表B.2住宅小區表（續）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明住宅小區地址編碼credit_codeString32M無條件共享無條件開放L1參考浙江省民政標準地名地址編碼相關規定住宅小區地址addressString64M無條件共享無條件開放L1行政區劃+鄉鎮街道+門牌號+小區(組)行政區域編碼region_codeString16M無條件共享無條件開放L1遵守GB/T2260和GB/T10114規定(示例參見國家統計局統計用區劃和城鄉劃分代碼政區域代碼)管轄單位聯系電話phone_numString16M無條件共享無條件開放L1管理物業單位責任人手機號碼管轄單位manager_companyString32M無條件共享無條件開放L1管理物業單位統一社會信用代碼會信用代碼單位占地面積occaupy_areaString16O無條件共享無條件開放L1單位：㎡總建筑面積build_areaString16O無條件共享無條件開放L1單位：㎡地圖類型map_typeInteger3C無條件共享無條件開放L1應符合附錄F的F.3(若填寫經緯必填)經度lngString16O無條件共享無條件開放L1精確到小數點后7位緯度latString16O無條件共享無條件開放L1精確到小數點后7位表B.2住宅小區表（續）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明創建時間create_timeString16M無條件共享無條件開放L1應符合ISO格式：yyyy-MM-ddHH:mm:ss修改時間update_timeString16M無條件共享無條件開放L1應符合ISO格式：yyyy-MM-ddHH:mm:ss注：M為必填，O為非必填，C符合說明中條件必填。（building）建筑物應符合表B.3。表B.3建筑物表中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明建筑物編號building_idString32M無條件共享無條件開放L1消防物聯網運營服務機構自定義建筑名稱building_nameString32M無條件共享無條件開放L1消防物聯網運營服務機構自定義運營服務機構唯一編碼parent_idString32M無條件共享無條件開放L1應符合附錄E的相關規定建筑地址addressString64M無條件共享無條件開放L1行政區劃+鄉鎮街道+門牌號+小區(組)+樓牌號建筑物地址編碼address_codeString64M無條件共享無條件開放L1參考浙江省民政標準地名地址編碼相關規定表B.3建筑物表（續）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明行政區域編碼region_codeString16M無條件共享無條件開放L1應符合GB/T2260和GB/T10114的規定統計局統計用區劃和城鄉劃分代碼碼需至村社級12位的行政區域代碼)建筑物類別building_typeString16M無條件共享無條件開放L1應符合附錄F的F.12建筑物類別關聯住宅小區編碼relation_idString16C無條件共享無條件開放L1若該建筑物屬填寫附錄B的B.2中的關聯住宅小區編碼管轄單位manager_companyString32M無條件共享無條件開放L1管理物業單位統一社會信用管理填寫街道社區的統一社會信用代碼產權單位owner_companyString32O無條件共享無條件開放L1支持多個產權單位統一社會入駐單位信息use_companysString1280無條件共享無條件開放L1支持多個入住單位統一社會使用性質building_usenatureString16O無條件共享無條件開放L1應符合附錄F的F.14使用性質表B.3建筑物表（續）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明火災危險性firedangerString160無條件共享無條件開放L1應符合附錄F的F.15火災危險性耐火等級fireresistant_levelString160無條件共享無條件開放L1應符合附錄F的F.16耐火等級結構類型structure_typeString160無條件共享無條件開放L1應符合附錄F的F.13建筑物結構類型建筑高度building_heightString160無條件共享無條件開放L1單位:米建造日期building_timeString160無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss建筑面積building_areaString160無條件共享無條件開放L1單位：㎡占地面積occupy_areaString160無條件共享無條件開放L1單位：㎡標準層面積standardfloor_areaString160無條件共享無條件開放L1單位：㎡地上層數overfloor_numInteger3M無條件共享無條件開放L1地上層面積overfloor_areaString160無條件共享無條件開放L1單位：㎡地下層數underfloor_numInteger2M無條件共享無條件開放L1地下層面積underfloor_areaString160無條件共享無條件開放L1單位：㎡隧道高度tunnel_heightString160無條件共享無條件開放L1單位：m隧道長度tunnel_lengthString160無條件共享無條件開放L1單位：m消控室位置controlroom_positionString160無條件共享無條件開放L1填寫消控室詳分隔日常工作時間人數workerdaily_numInteger50無條件共享無條件開放L1最大容納人數building_galleryfulInteger20無條件共享無條件開放L1消防電梯數量fireelevator_numInteger2M無條件共享無條件開放L1表B.3建筑物表（續）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明消防電梯容納總重量fireelevator_carreryString160無條件共享無條件開放L1單位：kg避難層數量shelterfloor_numInteger2M無條件共享無條件開放L1避難層總面積shelterfloor_areaString160無條件共享無條件開放L1單位：㎡避難層位置shelterfloor_positionString640無條件共享無條件開放L1安全出口數量exit_numInteger2M無條件共享無條件開放L1安全出口位置exit_positionString640無條件共享無條件開放L1安全出口形式exit_formString160無條件共享無條件開放L1設置類型有敞梯間和室外樓梯間存儲物名稱storage_nameString160無條件共享無條件開放L1存儲物數量storage_numInteger90無條件共享無條件開放L1存儲物性質storage_natureString160無條件共享無條件開放L1存儲物形態storage_shapeString160無條件共享無條件開放L1存儲容積storage_sizeString160無條件共享無條件開放L1單位：m3主要原料main_materialString160無條件共享無條件開放L1主要產品main_productString160無條件共享無條件開放L1入駐單位數entercompany_numInteger30無條件共享無條件開放L1安裝設備數device_numInteger30無條件共享無條件開放L1毗鄰建筑物情況company_abutsituationString1280無條件共享無條件開放L1地圖類型map_typeInteger3M無條件共享無條件開放L1應符合附錄F的F.3經度lngString16M無條件共享無條件開放L1精確到小數點后7位緯度latString16M無條件共享無條件開放L1精確到小數點后7位37表B.3建筑物表（續）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明創建時間create_timeString16M無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss修改時間update_timeString16M無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss注：M為必填，O為非必填，C符合說明中條件必填。（importantposition）重點部位應符合表B.4。表B.4重點部位表中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明重點部位唯一編碼importantposition_idString32M無條件共享無條件開放L1消防物聯網運營服務機構自定義重點部位名稱String16M無條件共享無條件開放L1消防物聯網運營服務機構自定義運營服務機構唯一編碼parent_idString32M無條件共享無條件開放L1應符合附錄E的相關規定關聯住宅小區編碼relation_idString16C無條件共享無條件開放L1屬于住宅小符合附錄B的B.2中的關聯住宅小區編碼所屬建筑物編號building_idString16M無條件共享無條件開放L1應符合附錄B的B.2中相關聯的建筑物編號建筑面積building_areaString16O無條件共享無條件開放L138表B.4 點位（）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明耐火等級fireresistant_levelString16O無條件共享無條件開放L1應符合附錄F的F.16耐火等級所在位置part_addrString64O無條件共享無條件開放L1使用性質building_usenatureString16O無條件共享無條件開放L1應符合附錄F的F.14使用性質消防設施情況facility_infoString128O無條件共享無條件開放L1消防設施名“；”分隔責任人姓名rspnperson_nameString16M無條件共享無條件開放L1責任人姓名責任人身份證rspnperson_idString160受限共享受限開放L2應符合GB11643的規定身份證件號碼責任人聯系電話rspnperson_numberString16M無條件共享無條件開放L1責任人手機號碼確立消防安全重點部位的原因reasonString128O無條件共享無條件開放L1描述該重點部位確立原因防火標志的設立情況firesign_infoString128O無條件共享無條件開放L1危險源情況hazard_sourceString128O無條件共享無條件開放L1是否存在化學品類、輻射類生物類、特種設備類、電氣類、土木工程類和交通運輸類危險源，使用分號“；”分隔消防安全管理措施safety_measuresString128O無條件共享無條件開放L1創建時間create_timeString16M無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss39表B.4 點位（）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明修改時間update_timeString16M無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss注：M為必填，O為非必填，C符合說明中條件必填。（device）物聯設備應符合表B.5。表B.5物聯設備表中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明設備編號device_idString32M無條件共享無條件開放L1消防物聯網運營服務機構自定義設備名稱device_nameString32M無條件共享無條件開放L1消防物聯網運營服務機構自定義運營服務機構唯一編碼parent_idString32M無條件共享無條件開放L1應符合附錄E的相關規定設備識別碼device_codeString64M無條件共享無條件開放L1設備物理編碼等)安裝位置locationString64M無條件共享無條件開放L1行政區劃+鄉鎮街道+門牌號+小區(組)+樓牌號+單元號+戶室設備廠商device_manufactoryString32M無條件共享無條件開放L1設備出廠廠商名稱設備類型device_typeString16M無條件共享無條件開放L1應符合附錄F的F.4相關規定3Ccode_3cString32C無條件共享無條件開放L1國家強制性要求，填寫要求應符合附錄F的F.440表B.5 聯備（）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明型式檢驗報告編號qualified_codeString32C無條件共享無條件開放L1檢驗報告編號，填寫3C字段關聯類型relation_typeString16M無條件共享無條件開放L1該物聯設備屬于聯網單位或住宅小區：1-聯網單位，2-住宅小區關聯編碼relation_idString32M無條件共享無條件開放L1該物聯設備所屬編碼填寫應符合附錄B的B.1中的關聯聯網單位編碼或附錄B的B.2中的關聯住宅小區編碼所屬建筑物編號building_idString32C無條件共享無條件開放L1應符合附錄B的B.4中相關聯的建筑物編號(室外消火栓，室外充電樁等無建筑關聯設施可不填寫所屬建筑物編號)施工單位名稱constructorString32O無條件共享無條件開放L1安裝物聯設備的廠家名稱設備生產時間produce_dateString16O無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss設備安裝時間install_dateString16O無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss41表B.5 聯備（）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明設備到期時間expire_dateString16O無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss部件總數parts_numInteger3O無條件共享無條件開放L1設備報警通知號碼notify_phoneString16O無條件共享無條件開放L1設備發生告警時需要聯系的消防負責人員手機號碼硬件版本hardware_versionString16O無條件共享無條件開放L1軟件版本software_versionString16O無條件共享無條件開放L1消控室位置String640無條件共享無條件開放L1填寫消控室詳細位置地圖類型map_typeInteger3C無條件共享無條件開放L1應符合附錄F的F.3(若填寫經緯度，地圖類型必填)經度lngString16O無條件共享無條件開放L1精確到小數點后7位緯度latString16O無條件共享無條件開放L1精確到小數點后7位創建時間create_timeString16M無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss修改時間update_timeString16M無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss注：M為必填，O為非必填，C符合說明中條件必填。部件（part）部件應符合表B.6。42表B.6部件表中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明部件唯一編號part_idString32M無條件共享無條件開放L1消防物聯網運營服務機構自定義部件名稱part_nameString32M無條件共享無條件開放L1消防物聯網運營服務機構自定義運營服務機parent_idString32M無條件共享無條件開放L1應符合附錄E的相關規定部件識別碼sensor_codeString32M無條件共享無條件開放L1設備物理編碼等)安裝位置addressString64M無條件共享無條件開放L1行政區劃+鄉鎮街道+門牌號+小區(組)+樓牌號+單元號+戶室部件類型parts_typeInteger3M無條件共享無條件開放L1應符合附錄F的F.5的相關規定關聯類型relation_typeString16M無條件共享無條件開放L1該物聯設備屬于聯網單位或住宅小區：1-聯網單位，2-住宅小區關聯編碼relation_idString32M無條件共享無條件開放L1該物聯設備所屬編碼填寫應符合附錄B的B.1中的關聯聯網單位編碼或附錄B的B.2中的關聯住宅小區編碼43表B.6 件（）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明所屬建筑物編號building_idString32C無條件共享無條件開放L1應符合附錄B的B.4中相關聯的建筑物編號(室外消火栓，室外充電樁等無建筑關聯設施可不填寫所屬建筑物編號)所屬設備編碼device_idString32M無條件共享無條件開放L1應符合附錄B的B.5中的設備編號3C證書編號code_3cString32C無條件共享無條件開放L1國家強制性要求，填寫要求應符合附錄F的F.5型式檢驗報告編號qualified_codeString32O無條件共享無條件開放L1檢驗報告編號，填寫3C字段部件生產廠商parts_manufactoryString32O無條件共享無條件開放L1部件生產時間produce_dateString16O無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss部件安裝時間install_dateString16O無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss部件到期時間expire_dateString16O無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss地圖類型map_typeInteger3C無條件共享無條件開放L1應符合附錄F的F.3(若填寫經緯度，地圖類型必填)44表B.6 件（）中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明經度lngString16O無條件共享無條件開放L1精確到小數點后7位緯度latString16O無條件共享無條件開放L1精確到小數點后7位創建時間create_timeString16M無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss修改時間update_timeString16M無條件共享無條件開放L1應符合ISO8601格式：yyyy-MM-ddHH:mm:ss注：M為必填，O為非必填，C符合說明中條件必填。（serviceagency）消防物聯網運營服務機構應符合表B.7。表B.7消防物聯網運營服務機構表中文名稱英文名稱數據類型長度是否可為空共享屬性開放屬性數據級別說明運營服務機構唯一編碼parent_idString32M無條件共享無條件開放L1應符合附錄E的相關規定消防物聯網運營服務機構名稱serviceagency_nameString32M無條件共享無條件開放L1消防物聯網運營服務機構自定義統一社會信用代碼company_codeS