消防物聯(lián)網系統(tǒng)對接技術規(guī)范

DB33/TXXXX—XXXX

消防物聯(lián)網系統(tǒng)對接技術規(guī)范

1范圍

本標準規(guī)定了消防物聯(lián)網系統(tǒng)數(shù)據對接的系統(tǒng)對接模型、基本要求和接口實現(xiàn)。

本標準適用于消防物聯(lián)網系統(tǒng)數(shù)據交互過程中接口協(xié)議的設計開發(fā)、運行管理和應用。

2規(guī)范性引用文件

下列文件中的內容通過文中的規(guī)范性引用而構成本標準必不可少的條款。其中，注日期的引用文件，

僅該日期對應的版本適用于本標準；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

標準。

GB/T2260中華人民共和國行政區(qū)劃代碼

GB/T4754—2017國民經濟行業(yè)分類

GB/T10114縣級以下行政區(qū)劃代碼編制規(guī)則

GB11643公民身份號碼

GB26875（所有部分）城市消防遠程監(jiān)控系統(tǒng)

GB/T28181—2016公共安全視頻監(jiān)控聯(lián)網系統(tǒng)信息傳輸、交換、控制技術要求

GB32100—2015法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則

GB50440城市消防遠程監(jiān)控系統(tǒng)技術規(guī)范

DB33/T2349數(shù)字化改革公共數(shù)據目錄編制規(guī)范

DB33/T2351數(shù)字化改革公共數(shù)據分類分級指南

ISO8601日期和時間信息交換表示法

IETFRFC2616超文本傳輸協(xié)議-HTTP/1.1(HypertextTransferProtocol-HTTP/1.1)

3術語和定義

GB26875（所有部分）和GB50440界定的以及下列術語和定義適用于本標準。

3.1

消防物聯(lián)網系統(tǒng)iotsystemforfire

利用物聯(lián)網技術采集消防相關的物、人、系統(tǒng)和信息資源，并進行處理的系統(tǒng)。

3.2

消防物聯(lián)網運營服務機構theoperationserviceagencyoffireiot

利用物聯(lián)網技術開展社會化消防運營服務的企事業(yè)單位。

3.3

聯(lián)網單位networkedunit

將火災預警信息、事件預警信息和故障信息，以及物聯(lián)設備運行狀態(tài)傳送到消防物聯(lián)網運營服務平

臺，并能接收消防物聯(lián)網運營服務平臺發(fā)送的相關信息的單位。

1

DB33/TXXXX—XXXX

4縮略語

下列縮略語適用于本標準。

AK：接口驗證序號（AccessKey）

AES：密碼學中的高級加密標準（AadvancedEncryptionStandard）

ECDH：一種基于橢圓曲線的密鑰協(xié)商算法

HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）

HTTPS：超文本傳輸安全協(xié)議（HyperTextTransferProtocolOverSecureSocketLayer）

IP：國際互聯(lián)協(xié)議（InternetProtocol）

JS：一種具有函數(shù)優(yōu)先的輕量級，解釋型或即時編譯型的編程語言（JavaScript）

JSON：JavaScript對象標記語言（JavaScriptObjectNotation）

REST：表述性狀態(tài)傳遞（RepresentationalStateTransfer）

SK：密鑰（SecretKey）

TLS：傳輸層安全性協(xié)議（TransportLayerSecurity）

URI：全局資源標識符（UniversalResourceIdentifier）

URL：統(tǒng)一資源定位符（UniformResoureLocator）

UTF-8：可變長度字符編碼（8-bitUnicodeTransformationForma）

5系統(tǒng)對接模型

5.1組成部分

系統(tǒng)對接模型由上級系統(tǒng)和下級系統(tǒng)組成，上級系統(tǒng)應具有數(shù)據查詢接口和數(shù)據推送接收接口。下

級系統(tǒng)應具有基礎資源數(shù)據，運營機構管理數(shù)據，消防物聯(lián)感知數(shù)據，消防物聯(lián)處置數(shù)據。系統(tǒng)數(shù)據架

構組成應與圖1相符合，下級系統(tǒng)業(yè)務數(shù)據具體如下：

a)基礎資源數(shù)據，包含聯(lián)網單位，住宅小區(qū)，建筑物，重點部位，物聯(lián)設備、部件，消防物聯(lián)

網運營服務機構，運營服務機構人員等信息；

b)運營機構管理數(shù)據，包含運營服務機構維保記錄和運營服務機構值班記錄；

c)消防物聯(lián)感知數(shù)據，包含運行狀態(tài)、監(jiān)測數(shù)據、故障信息、火災預警信息、事件預警信息、

消防視頻流；

d)消防物聯(lián)處置數(shù)據，包含火災預警處置信息、事件預警處置信息、故障處置信息。

2

DB33/TXXXX—XXXX

上級系統(tǒng)

數(shù)據查詢接口數(shù)據推送接口

基于REST的HTTP/HTTPS協(xié)議

下級系統(tǒng)

基礎資源數(shù)據消防物聯(lián)感知數(shù)據

聯(lián)網單位信息住宅小區(qū)信息建筑物信息監(jiān)控數(shù)據信息火災預警信息

重點部位信息物聯(lián)設備信息運營機構信息事件預警信息故障信息

部件信息運營機構人員信息消防視頻流運行狀態(tài)

消防物聯(lián)處置數(shù)據運營機構管理數(shù)據

火災預警處置信息事件預警處置故障處置信息運營機構值班記錄運營機構維保記錄

信息

圖1系統(tǒng)數(shù)對接模型圖

5.2對接功能

5.2.1下級系統(tǒng)應具備向上級系統(tǒng)提供接口以及級聯(lián)功能，基于REST的HTTP/HTTPS的傳輸方式。上

級平臺應支持接收下級系統(tǒng)上報基礎資源數(shù)據、運營機構管理數(shù)據、消防物聯(lián)感知數(shù)據、消防物聯(lián)處置

數(shù)據，并支持以主動查詢方式從下級系統(tǒng)獲取消防基礎資源數(shù)據、運營機構管理數(shù)據和消防物聯(lián)感知數(shù)

據、消防物聯(lián)處置數(shù)據。

5.2.2上級系統(tǒng)和下級系統(tǒng)應通過身份認證、傳輸加密、數(shù)據校驗等方式確保數(shù)據傳輸?shù)陌踩院涂?/p>

用性。

6基本要求

6.1功能要求

6.1.1數(shù)據查詢

下級系統(tǒng)提供全量數(shù)據和某一時間段內數(shù)據的查詢接口，上級系統(tǒng)可通過調用該接口查詢數(shù)據，數(shù)

據應符合5.1中的相關規(guī)定。

3

DB33/TXXXX—XXXX

基礎資源數(shù)據查詢對應接口實現(xiàn)應符合7.1中的相關規(guī)定。

6.1.2數(shù)據推送

當下級系統(tǒng)數(shù)據出現(xiàn)增加、修改、刪除情況時，下級系統(tǒng)能夠實時向上級平臺上報數(shù)據，數(shù)據應符

合5.1中的相關規(guī)定。

消防基礎資源數(shù)據上報對應接口說明應符合7.2中的相關規(guī)定。

6.1.3消防視頻調用

下級系統(tǒng)應具備消防重點部位視頻的開放能力，供上級系統(tǒng)實時調取查看。

視頻流的延時不超過5秒。

消防安全視頻調用對應接口說明應符合7.3中的相關規(guī)定。

6.2安全要求

6.2.1安全管理要求

下級系統(tǒng)向上級系統(tǒng)提交審核的內容，審核信息至少包含請求下級系統(tǒng)名稱，下級系統(tǒng)地址，統(tǒng)一

社會信用代碼，法定代表人姓名，法定代表人身份證號碼，法定代表人聯(lián)系電話，運營機構責任人姓名，

運營機構責任人聯(lián)系電話。

上級系統(tǒng)審核通過后，向下級系統(tǒng)發(fā)放身份憑證。

6.2.2身份認證

上級系統(tǒng)和下級系統(tǒng)之間相互訪問?；贖TTP/HTTPS時應采用符合附錄A中加密的安全摘要認證方

式，算法使用加密安全哈希算法HMAC-SHA256，平臺提供身份憑證，獲取身份密鑰（AK、SK）。

6.2.3數(shù)據加密

上級系統(tǒng)與下級系統(tǒng)之間在傳輸附錄B數(shù)據元描述中L2級別及L2級別以上數(shù)據字段時，需要先加密

再進行傳輸。HTTPS選用TLSV1.2加密協(xié)議，加密套件采用TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA256，

TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256，數(shù)字證書采用公開可信證書或者可信的自簽名X.509數(shù)字證

書。

6.2.4公共數(shù)據要求

上級系統(tǒng)與下級系統(tǒng)傳輸公共數(shù)據應符合DB33/T2349和DB33/T2351。

6.3數(shù)據傳輸時間要求

6.3.1數(shù)據查詢要求，下級系統(tǒng)接收到上級系統(tǒng)查詢請求后應在15秒內返回響應；分頁查詢時，下級

系統(tǒng)返回上級系統(tǒng)同一請求的響應時，數(shù)據包之間的時間間隔不得大于500毫秒。

6.3.2基礎資源數(shù)據、運營機構管理數(shù)據上報要求，基礎資源數(shù)據在發(fā)生變更或新的運營機構管理數(shù)

據產生時，應在10秒內上報至上級系統(tǒng)。

6.3.3故障、事件預警、火災預警信息上報要求，同一故障、事件預警、火災預警信息只上報一次，

下級平臺在接收到物聯(lián)設備上報的時間后，應在10秒內上報至上級系統(tǒng)；同一故障、事件預警、火災

預警處置信息，應在處置完成后10秒內上報至上級系統(tǒng)。

6.3.4狀態(tài)數(shù)據要求，物聯(lián)設備和部件狀態(tài)在發(fā)生變更時，應在10秒內上報至上級系統(tǒng)。

4

DB33/TXXXX—XXXX

6.3.5監(jiān)測數(shù)據上報頻率要求，下級系統(tǒng)在采集到物聯(lián)設備的監(jiān)測數(shù)據時，同一物聯(lián)設備應控制上報

頻率不小于10分鐘。

6.3.6視頻數(shù)據要求，視頻流傳輸延時不超過5秒。

6.4接口要求

協(xié)議參見附錄CREST，接口相對URL符合fire/*或fire/*/*。接口消息描述定義見附錄D中D.1接口

消息描述。

接口數(shù)據信息中運營服務機構唯一編碼應符合附錄E中運營服務機構唯一編碼規(guī)則的規(guī)定。

7接口實現(xiàn)

7.1數(shù)據查詢

7.1.1數(shù)據查詢流程

上級系統(tǒng)主動向下級系統(tǒng)發(fā)起數(shù)據查詢請求，下級系統(tǒng)按請求返回數(shù)據，具體流程應與圖2相符合。

上級系統(tǒng)下級系統(tǒng)

使用AK、SK、查詢參數(shù)

生成字符串TokenA

POST請求查詢接口，傳入查詢參數(shù)

請求頭部帶上認證字符串

驗證認證字符串

請求身份認證成功

根據查詢參數(shù)獲取查詢數(shù)據（涉及隱私則加密）

返回查詢數(shù)據

請求身份認證失敗

查詢失敗，身份認證未通過

圖2數(shù)據查詢流程

5

DB33/TXXXX—XXXX

生成認證字符串和驗證認證字符串應符合附錄A的A.1中的相關規(guī)定。

基礎資源數(shù)據在傳輸過程中，用于數(shù)據加密的流程和算法應符合附錄A的A.2中的相關規(guī)定。不涉及

隱私信息的數(shù)據可不做加密傳輸。

7.1.2通用查詢接口參數(shù)

上級系統(tǒng)向下級系統(tǒng)查詢數(shù)據，通用查詢請求頭參數(shù)應符合表1和通用查詢請求參數(shù)應符合表2。

表1通用查詢請求頭參數(shù)

名稱數(shù)據類型是否必填默認值說明

Client-TokenStringM(無)客戶端請求認證字符串

注：M為必填。

表2通用查詢請求參數(shù)

名稱數(shù)據類型是否必填默認值說明

startDateStringO(無)起始日期，應符合ISO8601標準

endDateStringO當前日期截止日期，應符合ISO8601標準

返回記錄的單頁數(shù)量，每次請求返回一頁記錄，數(shù)

pageSizeIntegerM1000據結果大于一頁時，需要多次請求獲取。

0＜pageSize≤1000

pageNoIntegerM(無)頁面序號，pageNo＞0

注：M為必填，O為非必填。

上級系統(tǒng)向下級系統(tǒng)查詢數(shù)據，通用查詢響應頭參數(shù)應符合表3和通用查詢返回參數(shù)應符合表4。

表3通用查詢響應頭參數(shù)

名稱數(shù)據類型是否必填默認值說明

Server-TokenStringM(無)服務響應認證字符串

注：M為必填。

表4通用查詢返回參數(shù)

名稱數(shù)據類型說明

codeString返回碼，0表示成功，其他值應符合附錄F的F.1錯誤碼

messageString接口執(zhí)行情況說明信息

dataObject返回值對象

7.1.3基礎數(shù)據查詢接口

聯(lián)網單位查詢接口

上級系統(tǒng)向下級系統(tǒng)查詢聯(lián)網單位數(shù)據,應符合表5～表6。

6

DB33/TXXXX—XXXX

表5聯(lián)網單位查詢接口

接口描述查詢與校正數(shù)據

相對URLfire/company/dataRows

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.1.2的相關規(guī)定，返回參數(shù)data字段應符

合表6。

表6返回參數(shù)data字段

名稱數(shù)據類型說明

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁面總數(shù)(與請求參數(shù)單頁數(shù)量計算獲得)

listsObject[]數(shù)據行數(shù)組，元素是聯(lián)網單位信息（company），應符合附錄B的B.1。

住宅小區(qū)查詢接口

上級系統(tǒng)向下級系統(tǒng)查詢住宅小區(qū)數(shù)據，應符合表7～表8。

表7住宅小區(qū)查詢接口

接口描述查詢與校正數(shù)據

相對URLfire/community/dataRows

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.1.2中的相關規(guī)定，返回參數(shù)data字段應

符合表8。

表8返回參數(shù)data字段

名稱數(shù)據類型說明

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁面總數(shù)(與請求參數(shù)單頁數(shù)量計算獲得)

listsObject[]數(shù)據行數(shù)組，元素是住宅小區(qū)信息（community），應符合附錄B的B.2

建筑物查詢接口

上級系統(tǒng)向下級系統(tǒng)查詢建筑物數(shù)據，應符合表9～表10。

7

DB33/TXXXX—XXXX

表9建筑物查詢接口

接口描述查詢與校正數(shù)據

相對URLfire/building/dataRows

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.1.2的相關規(guī)定，返回參數(shù)data字段應符

合表10。

表10返回參數(shù)data字段

名稱數(shù)據類型說明

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁面總數(shù)(與請求參數(shù)單頁數(shù)量計算獲得)

listsObject[]數(shù)據行數(shù)組，元素是建筑物信息（building），應符合附錄B的B.3

重點部位查詢接口

上級系統(tǒng)向下級系統(tǒng)查詢重點部位數(shù)據，應符合表11～表12。

表11重點部位查詢接口

接口描述查詢與校正數(shù)據

相對URLfire/importantposition/dataRows

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.1.2的相關規(guī)定，返回參數(shù)data字段應符

合表12。

表12返回參數(shù)data字段

名稱數(shù)據類型說明

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁面總數(shù)(與請求參數(shù)單頁數(shù)量計算獲得)

listsObject[]數(shù)據行數(shù)組，元素是重點部位數(shù)據，應符合附錄B的B.4。

物聯(lián)設備查詢接口

上級系統(tǒng)向下級系統(tǒng)查詢物聯(lián)設備數(shù)據，應符合表13～表14。

表13物聯(lián)設備查詢接口

接口描述查詢與校正數(shù)據

相對URLfire/firedevice/dataRows

方法POST

數(shù)據提交方式（Content-Type）application/json

8

DB33/TXXXX—XXXX

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.1.2的相關規(guī)定，返回參數(shù)data字段應符

合表14。

表14返回參數(shù)data字段

名稱數(shù)據類型說明

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁面總數(shù)(與請求參數(shù)單頁數(shù)量計算獲得)

listsObject[]數(shù)據行數(shù)組，元素是物聯(lián)設備信息（fireDevice），應符合附錄B的B.5

部件查詢接口

上級系統(tǒng)向下級系統(tǒng)查詢部件數(shù)據，應符合表15～表16。

表15部件查詢接口

接口描述查詢與校正數(shù)據

相對URLfire/part/dataRows

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.1.2的相關規(guī)定，返回參數(shù)data字段應符

合表16。

表16返回參數(shù)date字段

名稱數(shù)據類型說明

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁面總數(shù)(與請求參數(shù)單頁數(shù)量計算獲得)

listsObject[]數(shù)據行數(shù)組，元素是部件信息（sensor），應符合附錄B的B.6

運營機構查詢接口

上級系統(tǒng)向下級系統(tǒng)查詢消防物聯(lián)網運營服務機構數(shù)據，應符合表17～表18。

表17運營機構查詢接口

接口描述查詢與校正數(shù)據

相對URLfire/servicecompany/dataRows

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.1.2的相關規(guī)定，返回參數(shù)data字段應符

合表18。

9

DB33/TXXXX—XXXX

表18返回參數(shù)data字段

名稱數(shù)據類型說明

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁面總數(shù)(與請求參數(shù)單頁數(shù)量計算獲得)

listsObject[]數(shù)據行數(shù)組，元素是消防物聯(lián)網運營服務機構信息（serviceagency），應符合附錄B的B.7

運營機構人員查詢接口

上級系統(tǒng)向下級系統(tǒng)查詢運營服務機構人員數(shù)據，應符合表19～表20。

表19運營機構人員查詢接口

接口描述查詢與校正數(shù)據

相對URLfire/person/dataRows

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭和返回參數(shù)應符合7.1.2中的相關規(guī)定，返回參數(shù)data字段應符合

表20。

表20返回參數(shù)data字段

名稱數(shù)據類型說明

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁面總數(shù)(與請求參數(shù)單頁數(shù)量計算獲得)

listsObject[]數(shù)據行數(shù)組，元素是運營服務機構人員信息（person），應符合附錄B的B.8

7.1.4運營機構管理數(shù)據查詢接口

運營機構維保記錄查詢接口

上級系統(tǒng)向下級系統(tǒng)查詢運營機構維保記錄數(shù)據，應符合表21～表22。

表21運營機構維保記錄查詢接口

接口描述查詢與校正數(shù)據

相對URLfire/maintenance/dataRows

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.1.2中的相關規(guī)定，返回參數(shù)data字段應

符合表22。

10

DB33/TXXXX—XXXX

表22返回參數(shù)data字段

名稱數(shù)據類型說明

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁面總數(shù)(與請求參數(shù)單頁數(shù)量計算獲得)

listsObject[]數(shù)據行數(shù)組，元素是運營機構維保記錄（maintenance），應符合附錄B的B.17

運營機構值班記錄查詢接口

上級系統(tǒng)向下級系統(tǒng)查詢運營機構值班記錄數(shù)據，應符合表23～表24。

表23運營機構值班記錄查詢接口

接口描述查詢與校正數(shù)據

相對URLfire/dutyshift/dataRows

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.1.2中的相關規(guī)定，返回參數(shù)data字段應

符合表24。

表24返回參數(shù)data字段

名稱數(shù)據類型說明

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁面總數(shù)(與請求參數(shù)單頁數(shù)量計算獲得)

listsObject[]數(shù)據行數(shù)組，元素是運營機構值班記錄信息（dutyShift），應符合附錄B的B.18

7.2數(shù)據推送

7.2.1數(shù)據推送流程

當下級系統(tǒng)出現(xiàn)數(shù)據增加、修改、刪除情況時，下級系統(tǒng)通過http接口實時向上級系統(tǒng)上報數(shù)據。

具體流程應符合圖3。

11

DB33/TXXXX—XXXX

下級系統(tǒng)上級系統(tǒng)

使用AK、SK、加密后數(shù)據

生成認證字符串

POST請求數(shù)據上報接口，攜帶加密后數(shù)據

請求頭部帶上認證字符串

驗證認證字符串

請求身份認證成功

響應上報成功

使用密鑰解密以及協(xié)商的加密算法解密被加密的數(shù)據

請求身份認證失敗

上報失敗，身份認證未通過

圖3數(shù)據上報流程

生成認證字符串和驗證認證字符串應符合附錄A的A.1中的相關規(guī)定。

數(shù)據在傳輸過程中，用于數(shù)據加密的流程和算法應符合附錄A的A.2中的相關規(guī)定。不涉及隱私信息

的數(shù)據可不做加密傳輸。

7.2.2通用推送接口參數(shù)

下級系統(tǒng)數(shù)據發(fā)生變更后，需將變更信息上報至上級系統(tǒng)。通用推送請求頭參數(shù)應符合表25和通用

推送請求參數(shù)應符合表26。

表25通用推送請求頭參數(shù)

名稱數(shù)據類型是否必填默認值說明

Client-TokenStringM(無)客戶端請求認證字符串

注：M為必填。

12

DB33/TXXXX—XXXX

表26通用推送請求參數(shù)

名稱數(shù)據類型是否必填默認值說明

opt_typeIntegerM00-新增或修改，1-刪除

listsObject[]M(無)列表數(shù)據信息應合附錄B，刪除時只需填對應的數(shù)據id和parent_id

注：M為必填。

下級系統(tǒng)數(shù)據發(fā)生變更后，需將變更信息上報至上級系統(tǒng)，通用推送響應頭參數(shù)應符合表27和通用

推送返回參數(shù)應符合表28～29。

表27通用推送響應頭參數(shù)

名稱數(shù)據類型是否必填默認值說明

Server-TokenStringM(無)服務響應認證字符串

注：M為必填。

表28通用推送返回參數(shù)

名稱數(shù)據類型說明

codeString返回碼，0表示成功，其他值應符合附錄F的F.1錯誤碼

messageString接口執(zhí)行情況說明信息

dataObject返回值對象，內含successes和failures兩個列表，分別表示添加成功和失敗的數(shù)據列表

表29返回參數(shù)data字段

名稱數(shù)據類型說明

successesObject[]對象數(shù)組類型，表示添加成功數(shù)據列表

failuresObject[]對象數(shù)據類型，表示添加失敗數(shù)據列表

7.2.3基礎數(shù)據推送

聯(lián)網單位推送接口

下級系統(tǒng)新建、修改、刪除聯(lián)網單位后，將變更信息上報至上級系統(tǒng)，應符合表30～表32。

表30聯(lián)網單位推送接口

接口描述推送與校正數(shù)據

相對URLfire/company/update

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.2.2中的相關規(guī)定，返回參數(shù)successes

字段應符合表31，返回參數(shù)failures字段應符合表32。

13

DB33/TXXXX—XXXX

表31successes字段信息

名稱數(shù)據類型說明

company_idString聯(lián)網單位唯一編碼

表32failures字段信息

名稱數(shù)據類型說明

company_idString聯(lián)網單位唯一編碼

codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼

messageString錯誤信息

住宅小區(qū)推送接口

下級系統(tǒng)新建、修改、刪除住宅小區(qū)后，將變更信息上報至上級系統(tǒng)，應符合表33～表35。

表33住宅小區(qū)推送接口

接口描述推送與校正數(shù)據

相對URLfire/community/update

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.2.2中的相關規(guī)定，返回參數(shù)successes

字段應符合表34，返回參數(shù)failures字段應符合表35。

表34successes字段信息

名稱數(shù)據類型說明

community_idString住宅小區(qū)唯一編碼

表35failures字段信息

名稱數(shù)據類型說明

community_idString住宅小區(qū)唯一編碼

codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼

messageString錯誤信息

14

DB33/TXXXX—XXXX

建筑物推送接口

下級系統(tǒng)新建、修改、刪除建筑物后，將變更信息上報至上級系統(tǒng)，應符合表36～表38。

表36建筑物推送接口

接口描述推送與校正數(shù)據

相對URLfire/building/update

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.2.2中的相關規(guī)定，返回參數(shù)successes

字段應符合表37，返回參數(shù)failures字段應符合表38。

表37successes字段信息

名稱數(shù)據類型說明

building_idString建筑物唯一編碼

表38failures字段信息

名稱數(shù)據類型說明

building_idString建筑物唯一編碼

codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼

messageString錯誤信息

重點部位推送接口

下級系統(tǒng)新建、修改、刪除重點部位后，將變更信息上報至上級系統(tǒng)，應符合表39～表41。

表39重點部位推送接口

接口描述推送與校正數(shù)據

相對URLfire/importantposition/update

方法POST

數(shù)據提交方式

application/json

（Content-Type）

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.2.2中的相關規(guī)定，返回參數(shù)successes

字段應符合表40，返回參數(shù)failures字段應符合表41。

表40successes字段信息

名稱數(shù)據類型說明

importantposition_idString重點部位唯一編碼

15

DB33/TXXXX—XXXX

表41failures字段信息

名稱數(shù)據類型說明

importantposition_idString重點部位唯一編碼

codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼

messageString錯誤信息

物聯(lián)設備推送接口

下級系統(tǒng)新建、修改、刪除物聯(lián)設備后，將變更信息上報至上級系統(tǒng)，應符合表42～表44。

表42物聯(lián)設備推送接口

接口描述推送與校正數(shù)據

相對URLfire/device/update

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.2.2中的相關規(guī)定，返回參數(shù)successes

字段應符合表43，返回參數(shù)failures字段應符合表44。

表43successes字段信息

名稱數(shù)據類型說明

device_idString物聯(lián)設備唯一編碼

表44failures字段信息

名稱數(shù)據類型說明

device_idString物聯(lián)設備唯一編碼

codeString錯誤碼，詳情應符合附錄F的F.1錯誤碼

messageString錯誤信息

部件推送接口

下級系統(tǒng)新建、修改、刪除部件后，將變更信息上報至上級系統(tǒng)，應符合表45～表47。

表45部件推送接口

接口描述推送與校正數(shù)據

相對URLfire/part/update

方法POST

數(shù)據提交方式（Content-Type）application/json

請求頭參數(shù)和請求參數(shù)、響應頭參數(shù)和返回參數(shù)應符合7.2.2中的相關規(guī)定，返回參數(shù)successes

字段應符合表46，返回參數(shù)failures字段應符合表47。

16

DB33/TXXXX—XXXX

表46successes字段信息

名稱數(shù)據類型說明

part_idString部件唯一編碼

表47failures字段信息

名稱