消防物聯(lián)網(wǎng)系統(tǒng)對(duì)接技術(shù)規(guī)范

DB33/TXXXX—XXXX

消防物聯(lián)網(wǎng)系統(tǒng)對(duì)接技術(shù)規(guī)范

1范圍

本標(biāo)準(zhǔn)規(guī)定了消防物聯(lián)網(wǎng)系統(tǒng)數(shù)據(jù)對(duì)接的系統(tǒng)對(duì)接模型、基本要求和接口實(shí)現(xiàn)。

本標(biāo)準(zhǔn)適用于消防物聯(lián)網(wǎng)系統(tǒng)數(shù)據(jù)交互過(guò)程中接口協(xié)議的設(shè)計(jì)開發(fā)、運(yùn)行管理和應(yīng)用。

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

下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本標(biāo)準(zhǔn)必不可少的條款。其中，注日期的引用文件，

僅該日期對(duì)應(yīng)的版本適用于本標(biāo)準(zhǔn)；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

標(biāo)準(zhǔn)。

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

GB/T4754—2017國(guó)民經(jīng)濟(jì)行業(yè)分類

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

GB11643公民身份號(hào)碼

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

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

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

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

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

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

ISO8601日期和時(shí)間信息交換表示法

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

3術(shù)語(yǔ)和定義

GB26875（所有部分）和GB50440界定的以及下列術(shù)語(yǔ)和定義適用于本標(biāo)準(zhǔn)。

3.1

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

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

3.2

消防物聯(lián)網(wǎng)運(yùn)營(yíng)服務(wù)機(jī)構(gòu)theoperationserviceagencyoffireiot

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

3.3

聯(lián)網(wǎng)單位networkedunit

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

臺(tái)，并能接收消防物聯(lián)網(wǎng)運(yùn)營(yíng)服務(wù)平臺(tái)發(fā)送的相關(guān)信息的單位。

1

DB33/TXXXX—XXXX

4縮略語(yǔ)

下列縮略語(yǔ)適用于本標(biāo)準(zhǔn)。

AK：接口驗(yàn)證序號(hào)（AccessKey）

AES：密碼學(xué)中的高級(jí)加密標(biāo)準(zhǔn)（AadvancedEncryptionStandard）

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

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

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

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

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

JSON：JavaScript對(duì)象標(biāo)記語(yǔ)言（JavaScriptObjectNotation）

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

SK：密鑰（SecretKey）

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

URI：全局資源標(biāo)識(shí)符（UniversalResourceIdentifier）

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

UTF-8：可變長(zhǎng)度字符編碼（8-bitUnicodeTransformationForma）

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

5.1組成部分

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

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

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

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

網(wǎng)運(yùn)營(yíng)服務(wù)機(jī)構(gòu)，運(yùn)營(yíng)服務(wù)機(jī)構(gòu)人員等信息；

b)運(yùn)營(yíng)機(jī)構(gòu)管理數(shù)據(jù)，包含運(yùn)營(yíng)服務(wù)機(jī)構(gòu)維保記錄和運(yùn)營(yíng)服務(wù)機(jī)構(gòu)值班記錄；

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

消防視頻流；

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

2

DB33/TXXXX—XXXX

上級(jí)系統(tǒng)

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

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

下級(jí)系統(tǒng)

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

聯(lián)網(wǎng)單位信息住宅小區(qū)信息建筑物信息監(jiān)控?cái)?shù)據(jù)信息火災(zāi)預(yù)警信息

重點(diǎn)部位信息物聯(lián)設(shè)備信息運(yùn)營(yíng)機(jī)構(gòu)信息事件預(yù)警信息故障信息

部件信息運(yùn)營(yíng)機(jī)構(gòu)人員信息消防視頻流運(yùn)行狀態(tài)

消防物聯(lián)處置數(shù)據(jù)運(yùn)營(yíng)機(jī)構(gòu)管理數(shù)據(jù)

火災(zāi)預(yù)警處置信息事件預(yù)警處置故障處置信息運(yùn)營(yíng)機(jī)構(gòu)值班記錄運(yùn)營(yíng)機(jī)構(gòu)維保記錄

信息

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

5.2對(duì)接功能

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

級(jí)平臺(tái)應(yīng)支持接收下級(jí)系統(tǒng)上報(bào)基礎(chǔ)資源數(shù)據(jù)、運(yùn)營(yíng)機(jī)構(gòu)管理數(shù)據(jù)、消防物聯(lián)感知數(shù)據(jù)、消防物聯(lián)處置

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

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

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

用性。

6基本要求

6.1功能要求

6.1.1數(shù)據(jù)查詢

下級(jí)系統(tǒng)提供全量數(shù)據(jù)和某一時(shí)間段內(nèi)數(shù)據(jù)的查詢接口，上級(jí)系統(tǒng)可通過(guò)調(diào)用該接口查詢數(shù)據(jù)，數(shù)

據(jù)應(yīng)符合5.1中的相關(guān)規(guī)定。

3

DB33/TXXXX—XXXX

基礎(chǔ)資源數(shù)據(jù)查詢對(duì)應(yīng)接口實(shí)現(xiàn)應(yīng)符合7.1中的相關(guān)規(guī)定。

6.1.2數(shù)據(jù)推送

當(dāng)下級(jí)系統(tǒng)數(shù)據(jù)出現(xiàn)增加、修改、刪除情況時(shí)，下級(jí)系統(tǒng)能夠?qū)崟r(shí)向上級(jí)平臺(tái)上報(bào)數(shù)據(jù)，數(shù)據(jù)應(yīng)符

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

消防基礎(chǔ)資源數(shù)據(jù)上報(bào)對(duì)應(yīng)接口說(shuō)明應(yīng)符合7.2中的相關(guān)規(guī)定。

6.1.3消防視頻調(diào)用

下級(jí)系統(tǒng)應(yīng)具備消防重點(diǎn)部位視頻的開放能力，供上級(jí)系統(tǒng)實(shí)時(shí)調(diào)取查看。

視頻流的延時(shí)不超過(guò)5秒。

消防安全視頻調(diào)用對(duì)應(yīng)接口說(shuō)明應(yīng)符合7.3中的相關(guān)規(guī)定。

6.2安全要求

6.2.1安全管理要求

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

社會(huì)信用代碼，法定代表人姓名，法定代表人身份證號(hào)碼，法定代表人聯(lián)系電話，運(yùn)營(yíng)機(jī)構(gòu)責(zé)任人姓名，

運(yùn)營(yíng)機(jī)構(gòu)責(zé)任人聯(lián)系電話。

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

6.2.2身份認(rèn)證

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

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

6.2.3數(shù)據(jù)加密

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

再進(jìn)行傳輸。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ù)據(jù)要求

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

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

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

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

6.3.2基礎(chǔ)資源數(shù)據(jù)、運(yùn)營(yíng)機(jī)構(gòu)管理數(shù)據(jù)上報(bào)要求，基礎(chǔ)資源數(shù)據(jù)在發(fā)生變更或新的運(yùn)營(yíng)機(jī)構(gòu)管理數(shù)

據(jù)產(chǎn)生時(shí)，應(yīng)在10秒內(nèi)上報(bào)至上級(jí)系統(tǒng)。

6.3.3故障、事件預(yù)警、火災(zāi)預(yù)警信息上報(bào)要求，同一故障、事件預(yù)警、火災(zāi)預(yù)警信息只上報(bào)一次，

下級(jí)平臺(tái)在接收到物聯(lián)設(shè)備上報(bào)的時(shí)間后，應(yīng)在10秒內(nèi)上報(bào)至上級(jí)系統(tǒng)；同一故障、事件預(yù)警、火災(zāi)

預(yù)警處置信息，應(yīng)在處置完成后10秒內(nèi)上報(bào)至上級(jí)系統(tǒng)。

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

4

DB33/TXXXX—XXXX

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

頻率不小于10分鐘。

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

6.4接口要求

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

消息描述。

接口數(shù)據(jù)信息中運(yùn)營(yíng)服務(wù)機(jī)構(gòu)唯一編碼應(yīng)符合附錄E中運(yùn)營(yíng)服務(wù)機(jī)構(gòu)唯一編碼規(guī)則的規(guī)定。

7接口實(shí)現(xiàn)

7.1數(shù)據(jù)查詢

7.1.1數(shù)據(jù)查詢流程

上級(jí)系統(tǒng)主動(dòng)向下級(jí)系統(tǒng)發(fā)起數(shù)據(jù)查詢請(qǐng)求，下級(jí)系統(tǒng)按請(qǐng)求返回?cái)?shù)據(jù)，具體流程應(yīng)與圖2相符合。

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

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

生成字符串TokenA

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

請(qǐng)求頭部帶上認(rèn)證字符串

驗(yàn)證認(rèn)證字符串

請(qǐng)求身份認(rèn)證成功

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

返回查詢數(shù)據(jù)

請(qǐng)求身份認(rèn)證失敗

查詢失敗，身份認(rèn)證未通過(guò)

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

5

DB33/TXXXX—XXXX

生成認(rèn)證字符串和驗(yàn)證認(rèn)證字符串應(yīng)符合附錄A的A.1中的相關(guān)規(guī)定。

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

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

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

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

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

名稱數(shù)據(jù)類型是否必填默認(rèn)值說(shuō)明

Client-TokenStringM(無(wú))客戶端請(qǐng)求認(rèn)證字符串

注：M為必填。

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

名稱數(shù)據(jù)類型是否必填默認(rèn)值說(shuō)明

startDateStringO(無(wú))起始日期，應(yīng)符合ISO8601標(biāo)準(zhǔn)

endDateStringO當(dāng)前日期截止日期，應(yīng)符合ISO8601標(biāo)準(zhǔn)

返回記錄的單頁(yè)數(shù)量，每次請(qǐng)求返回一頁(yè)記錄，數(shù)

pageSizeIntegerM1000據(jù)結(jié)果大于一頁(yè)時(shí)，需要多次請(qǐng)求獲取。

0＜pageSize≤1000

pageNoIntegerM(無(wú))頁(yè)面序號(hào)，pageNo＞0

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

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

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

名稱數(shù)據(jù)類型是否必填默認(rèn)值說(shuō)明

Server-TokenStringM(無(wú))服務(wù)響應(yīng)認(rèn)證字符串

注：M為必填。

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

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

codeString返回碼，0表示成功，其他值應(yīng)符合附錄F的F.1錯(cuò)誤碼

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

dataObject返回值對(duì)象

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

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

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

6

DB33/TXXXX—XXXX

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

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

相對(duì)URLfire/company/dataRows

方法POST

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

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

合表6。

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

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

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁(yè)面總數(shù)(與請(qǐng)求參數(shù)單頁(yè)數(shù)量計(jì)算獲得)

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

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

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

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

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

相對(duì)URLfire/community/dataRows

方法POST

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

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

符合表8。

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

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

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁(yè)面總數(shù)(與請(qǐng)求參數(shù)單頁(yè)數(shù)量計(jì)算獲得)

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

建筑物查詢接口

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

7

DB33/TXXXX—XXXX

表9建筑物查詢接口

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

相對(duì)URLfire/building/dataRows

方法POST

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

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

合表10。

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

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

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁(yè)面總數(shù)(與請(qǐng)求參數(shù)單頁(yè)數(shù)量計(jì)算獲得)

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

重點(diǎn)部位查詢接口

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

表11重點(diǎn)部位查詢接口

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

相對(duì)URLfire/importantposition/dataRows

方法POST

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

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

合表12。

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

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

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁(yè)面總數(shù)(與請(qǐng)求參數(shù)單頁(yè)數(shù)量計(jì)算獲得)

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

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

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

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

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

相對(duì)URLfire/firedevice/dataRows

方法POST

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

8

DB33/TXXXX—XXXX

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

合表14。

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

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

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁(yè)面總數(shù)(與請(qǐng)求參數(shù)單頁(yè)數(shù)量計(jì)算獲得)

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

部件查詢接口

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

表15部件查詢接口

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

相對(duì)URLfire/part/dataRows

方法POST

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

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

合表16。

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

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

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁(yè)面總數(shù)(與請(qǐng)求參數(shù)單頁(yè)數(shù)量計(jì)算獲得)

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

運(yùn)營(yíng)機(jī)構(gòu)查詢接口

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

表17運(yùn)營(yíng)機(jī)構(gòu)查詢接口

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

相對(duì)URLfire/servicecompany/dataRows

方法POST

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

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

合表18。

9

DB33/TXXXX—XXXX

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

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

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁(yè)面總數(shù)(與請(qǐng)求參數(shù)單頁(yè)數(shù)量計(jì)算獲得)

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

運(yùn)營(yíng)機(jī)構(gòu)人員查詢接口

上級(jí)系統(tǒng)向下級(jí)系統(tǒng)查詢運(yùn)營(yíng)服務(wù)機(jī)構(gòu)人員數(shù)據(jù)，應(yīng)符合表19～表20。

表19運(yùn)營(yíng)機(jī)構(gòu)人員查詢接口

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

相對(duì)URLfire/person/dataRows

方法POST

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

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

表20。

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

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

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁(yè)面總數(shù)(與請(qǐng)求參數(shù)單頁(yè)數(shù)量計(jì)算獲得)

listsObject[]數(shù)據(jù)行數(shù)組，元素是運(yùn)營(yíng)服務(wù)機(jī)構(gòu)人員信息（person），應(yīng)符合附錄B的B.8

7.1.4運(yùn)營(yíng)機(jī)構(gòu)管理數(shù)據(jù)查詢接口

運(yùn)營(yíng)機(jī)構(gòu)維保記錄查詢接口

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

表21運(yùn)營(yíng)機(jī)構(gòu)維保記錄查詢接口

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

相對(duì)URLfire/maintenance/dataRows

方法POST

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

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

符合表22。

10

DB33/TXXXX—XXXX

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

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

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁(yè)面總數(shù)(與請(qǐng)求參數(shù)單頁(yè)數(shù)量計(jì)算獲得)

listsObject[]數(shù)據(jù)行數(shù)組，元素是運(yùn)營(yíng)機(jī)構(gòu)維保記錄（maintenance），應(yīng)符合附錄B的B.17

運(yùn)營(yíng)機(jī)構(gòu)值班記錄查詢接口

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

表23運(yùn)營(yíng)機(jī)構(gòu)值班記錄查詢接口

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

相對(duì)URLfire/dutyshift/dataRows

方法POST

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

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

符合表24。

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

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

rowCountInteger返回記錄數(shù)

pageCountInteger返回頁(yè)面總數(shù)(與請(qǐng)求參數(shù)單頁(yè)數(shù)量計(jì)算獲得)

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

7.2數(shù)據(jù)推送

7.2.1數(shù)據(jù)推送流程

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

具體流程應(yīng)符合圖3。

11

DB33/TXXXX—XXXX

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

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

生成認(rèn)證字符串

POST請(qǐng)求數(shù)據(jù)上報(bào)接口，攜帶加密后數(shù)據(jù)

請(qǐng)求頭部帶上認(rèn)證字符串

驗(yàn)證認(rèn)證字符串

請(qǐng)求身份認(rèn)證成功

響應(yīng)上報(bào)成功

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

請(qǐng)求身份認(rèn)證失敗

上報(bào)失敗，身份認(rèn)證未通過(guò)

圖3數(shù)據(jù)上報(bào)流程

生成認(rèn)證字符串和驗(yàn)證認(rèn)證字符串應(yīng)符合附錄A的A.1中的相關(guān)規(guī)定。

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

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

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

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

推送請(qǐng)求參數(shù)應(yīng)符合表26。

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

名稱數(shù)據(jù)類型是否必填默認(rèn)值說(shuō)明

Client-TokenStringM(無(wú))客戶端請(qǐng)求認(rèn)證字符串

注：M為必填。

12

DB33/TXXXX—XXXX

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

名稱數(shù)據(jù)類型是否必填默認(rèn)值說(shuō)明

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

listsObject[]M(無(wú))列表數(shù)據(jù)信息應(yīng)合附錄B，刪除時(shí)只需填對(duì)應(yīng)的數(shù)據(jù)id和parent_id

注：M為必填。

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

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

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

名稱數(shù)據(jù)類型是否必填默認(rèn)值說(shuō)明

Server-TokenStringM(無(wú))服務(wù)響應(yīng)認(rèn)證字符串

注：M為必填。

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

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

codeString返回碼，0表示成功，其他值應(yīng)符合附錄F的F.1錯(cuò)誤碼

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

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

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

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

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

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

7.2.3基礎(chǔ)數(shù)據(jù)推送

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

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

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

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

相對(duì)URLfire/company/update

方法POST

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

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

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

13

DB33/TXXXX—XXXX

表31successes字段信息

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

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

表32failures字段信息

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

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

codeString錯(cuò)誤碼，詳情應(yīng)符合附錄F的F.1錯(cuò)誤碼

messageString錯(cuò)誤信息

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

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

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

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

相對(duì)URLfire/community/update

方法POST

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

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

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

表34successes字段信息

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

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

表35failures字段信息

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

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

codeString錯(cuò)誤碼，詳情應(yīng)符合附錄F的F.1錯(cuò)誤碼

messageString錯(cuò)誤信息

14

DB33/TXXXX—XXXX

建筑物推送接口

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

表36建筑物推送接口

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

相對(duì)URLfire/building/update

方法POST

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

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

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

表37successes字段信息

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

building_idString建筑物唯一編碼

表38failures字段信息

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

building_idString建筑物唯一編碼

codeString錯(cuò)誤碼，詳情應(yīng)符合附錄F的F.1錯(cuò)誤碼

messageString錯(cuò)誤信息

重點(diǎn)部位推送接口

下級(jí)系統(tǒng)新建、修改、刪除重點(diǎn)部位后，將變更信息上報(bào)至上級(jí)系統(tǒng)，應(yīng)符合表39～表41。

表39重點(diǎn)部位推送接口

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

相對(duì)URLfire/importantposition/update

方法POST

數(shù)據(jù)提交方式

application/json

（Content-Type）

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

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

表40successes字段信息

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

importantposition_idString重點(diǎn)部位唯一編碼

15

DB33/TXXXX—XXXX

表41failures字段信息

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

importantposition_idString重點(diǎn)部位唯一編碼

codeString錯(cuò)誤碼，詳情應(yīng)符合附錄F的F.1錯(cuò)誤碼

messageString錯(cuò)誤信息

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

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

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

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

相對(duì)URLfire/device/update

方法POST

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

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

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

表43successes字段信息

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

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

表44failures字段信息

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

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

codeString錯(cuò)誤碼，詳情應(yīng)符合附錄F的F.1錯(cuò)誤碼

messageString錯(cuò)誤信息

部件推送接口

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

表45部件推送接口

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

相對(duì)URLfire/part/update

方法POST

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

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

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

16

DB33/TXXXX—XXXX

表46successes字段信息

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

part_idString部件唯一編碼

表47failures字段信息

名稱