ICS35.240.01

L70

DB36

江西省地方標準

DB36/T1296—2020

城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺接口規(guī)范

InterfacespecificationforurbanfireIoTbigdataapplicationplatform

2020-XX-XX發(fā)布2020-XX-XX實施

江西省市場監(jiān)督管理局發(fā)布

DB36/T1296—2020

目次

前言............................................................................................................................................................II

1范圍..............................................................................................................................................................1

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

3術(shù)語和定義..................................................................................................................................................1

4體系架構(gòu)及協(xié)議層次..................................................................................................................................3

5應(yīng)用協(xié)議......................................................................................................................................................4

6通信流程......................................................................................................................................................7

附錄A（規(guī)范性附錄）編碼信息................................................................................................................43

附錄B（資料性附錄）調(diào)用示例................................................................................................................60

本規(guī)程用詞說明............................................................................................................................................122

I

DB36/T1296—2020

前言

本規(guī)范按照GB/T1.1-2020的規(guī)定起草。

本規(guī)范的某些內(nèi)容可能涉及專利，本文件發(fā)布機構(gòu)不應(yīng)承擔識別這些專利的責任。

本規(guī)范由江西省消防救援總隊提出并歸口。

本規(guī)范主要起草單位：江西省消防救援總隊、中國信息通信研究院。

本規(guī)范參編單位：中國電信集團有限公司江西分公司、中國移動通信集團公司江西分公司、中國聯(lián)

合網(wǎng)絡(luò)通信集團有限公司江西省分公司、南昌航空大學(xué)軟件學(xué)院院。

本規(guī)范起草人：朱飛勇、萬灝、李論、張然、張振庭、陳淼、郭英男、陳琨、夏成華、萬偉、劉偉

琦、馬紅霞、吳君卓、王歡、朱玲紅、孫晨、陳呂義、趙旭、余灃、王丹東、李童斐、周爾東、羅佳佳、

傅強。

II

DB36/T1296—2020

城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺接口規(guī)范

1范圍

本規(guī)范用于規(guī)定本省范圍內(nèi)省、市、縣級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺之間，以及城市消防物聯(lián)

網(wǎng)大數(shù)據(jù)應(yīng)用平臺與社會單位、行業(yè)部門等其他消防管理服務(wù)平臺之間的數(shù)據(jù)交換。

本規(guī)范規(guī)定了數(shù)據(jù)交換過程的應(yīng)用層通信協(xié)議。

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

下列文件對于本規(guī)范的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本規(guī)

范。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本規(guī)范。

GB/T4754-2017國民經(jīng)濟分類

GB/T12402-2000經(jīng)濟類型分類與代碼

GB12955-2015防火門

GB14287-2014（所有部分）電氣火災(zāi)監(jiān)控系統(tǒng)

GB16806-2006消防聯(lián)動控制系統(tǒng)

GB/T22239-2019信息安全技術(shù)網(wǎng)絡(luò)安全等級保護基本要求

GB25201-2010建筑消防設(shè)施的維護管理

GB25506-2010消防控制室通用技術(shù)要求

GB25972-2010氣體滅火系統(tǒng)及部件

GB/T26875.3-2011城市消防遠程監(jiān)控系統(tǒng)第3部分：報警傳輸網(wǎng)絡(luò)通信協(xié)議

GB/T26875.4-2011城市消防遠程監(jiān)控系統(tǒng)第4部分：基礎(chǔ)數(shù)據(jù)項

GB/T30269.701-2014信息技術(shù)傳感器網(wǎng)絡(luò)第701部分：傳感器接口：信號接口

GB50016-2014建筑設(shè)計防火規(guī)范

GB50084-2017自動噴水滅火系統(tǒng)設(shè)計規(guī)范

GB50116-2013火災(zāi)自動報警系統(tǒng)設(shè)計規(guī)范

GB50166-2019火災(zāi)自動報警系統(tǒng)施工及驗收規(guī)范

GB50219-2014水噴霧滅火系統(tǒng)設(shè)計規(guī)范

GB50261-2017自動噴水滅火系統(tǒng)施工及驗收規(guī)范

GB50370-2005氣體滅火系統(tǒng)設(shè)計規(guī)范

GA/T396-2002消防業(yè)務(wù)基礎(chǔ)數(shù)據(jù)元與代碼表

GA/T1038.1-2012消防公共服務(wù)平臺技術(shù)規(guī)范第1部分：總體架構(gòu)及功能要求

GA/T1038.2-2012消防公共服務(wù)平臺技術(shù)規(guī)范第2部分：服務(wù)管理接口

GA/T1038.3-2012消防公共服務(wù)平臺技術(shù)規(guī)范第3部分：信息交換接口

GM/T0054-2018信息系統(tǒng)密碼應(yīng)用基本要求

3術(shù)語和定義

1

DB36/T1296—2020

下列術(shù)語和定義適用于本規(guī)范。

3.1

城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺urbanfireIoTbigdataapplicationplatform

由政府統(tǒng)一建設(shè)的用于消防監(jiān)督管理的消防大數(shù)據(jù)應(yīng)用平臺，按照行政區(qū)劃劃分為省級、市級、縣

級等，服務(wù)于各級消防部門、行業(yè)部門、消防單位、維保、設(shè)備等消防產(chǎn)業(yè)企業(yè)。

3.2

消防管理服務(wù)平臺managementplatformofFIoT

由社會單位建設(shè)的，負責信息感知設(shè)備的接入、管理、控制并提供相關(guān)基礎(chǔ)應(yīng)用服務(wù)的平臺。

3.3

平臺管理platformmanagement

由政府統(tǒng)一建設(shè)的縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺需要通過訪問上級城市消防物聯(lián)網(wǎng)大數(shù)

據(jù)應(yīng)用平臺相關(guān)接口，完成平臺的注冊、變更等管理操作。社會單位建設(shè)的消防管理服務(wù)平臺需要通過

訪問本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺相關(guān)接口，完成平臺的注冊、變更等管理操作。

3.4

數(shù)據(jù)字典下載datadictionarydownload

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺和消防管理服務(wù)平臺完成注冊后需要從省級城市消防物聯(lián)

網(wǎng)大數(shù)據(jù)應(yīng)用平臺中下載數(shù)據(jù)字典，以保證各類數(shù)據(jù)統(tǒng)一編碼。

3.5

靜態(tài)數(shù)據(jù)上傳staticdataupload

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺擁有的靜態(tài)數(shù)據(jù)向上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺進

行數(shù)據(jù)傳輸，消防管理服務(wù)平臺擁有的靜態(tài)數(shù)據(jù)向本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺進行數(shù)據(jù)傳輸。

3.6

動態(tài)數(shù)據(jù)上傳dynamicdataupload

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺擁有的動態(tài)數(shù)據(jù)向上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺進

行數(shù)據(jù)傳輸，消防管理服務(wù)平臺擁有的動態(tài)數(shù)據(jù)向本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺進行數(shù)據(jù)傳輸。

3.7

操作數(shù)據(jù)上傳operationdataupload

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺擁有的操作數(shù)據(jù)向上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺進

行數(shù)據(jù)傳輸，消防管理服務(wù)平臺擁有的操作數(shù)據(jù)向本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺進行數(shù)據(jù)傳輸。

3.8

數(shù)據(jù)下發(fā)datadownlink

2

DB36/T1296—2020

省、市、縣級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺根據(jù)業(yè)務(wù)需求下傳各類消防數(shù)據(jù)。

4體系架構(gòu)及協(xié)議層次

4.1體系架構(gòu)

省、市、縣級政府消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺間及本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺與消防管理

服務(wù)平臺之間的邏輯架構(gòu)如圖1所示。

圖1體系架構(gòu)

4.2協(xié)議層次與安全要求

4.2.1省、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺與市、縣級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺之間的協(xié)

議關(guān)系如圖2所示。

圖2協(xié)議層次

4.2.2消防管理服務(wù)平臺與本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺之間的協(xié)議關(guān)系如圖3所示。

3

DB36/T1296—2020

圖3協(xié)議層次

4.2.3城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺應(yīng)通過身份認證、傳輸加密、數(shù)據(jù)校驗等方式確保數(shù)據(jù)傳輸?shù)?/p>

安全性，并應(yīng)符合GB/T22239-2019、GM/T0054-2018等相關(guān)規(guī)定。

5應(yīng)用協(xié)議

5.1一般規(guī)定

5.1.1身份驗證

省、市、縣級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺間，以及消防管理服務(wù)平臺與本級城市消防物聯(lián)網(wǎng)大

數(shù)據(jù)應(yīng)用平臺間進行數(shù)據(jù)交互時，需采用統(tǒng)一要求的CA數(shù)字證書進行身份驗證。

5.1.2應(yīng)用接口協(xié)議

省、市、縣級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺間，以及消防管理服務(wù)平臺與本級城市消防物聯(lián)網(wǎng)大

數(shù)據(jù)應(yīng)用平臺間的應(yīng)用接口協(xié)議包含平臺管理、數(shù)據(jù)字典下載、靜態(tài)數(shù)據(jù)上傳、動態(tài)數(shù)據(jù)上傳、操作數(shù)

據(jù)上傳、數(shù)據(jù)下發(fā)等協(xié)議，具體框架見圖4。

圖4應(yīng)用接口協(xié)議

5.1.3應(yīng)用接口協(xié)議格式

應(yīng)用接口協(xié)議格式見表1。

4

DB36/T1296—2020

表1應(yīng)用接口協(xié)議格式

協(xié)議POST

編碼格式UTF-8

URL示例https://IP地址:端口號/api/版本號（version）/接口名稱（interfaceName）

注：version表示版本號，初始版本號為v1，支持版本號遞增，并向前兼容。interfaceName表示接口名稱，詳細見

各業(yè)務(wù)接口定義。

5.1.4請求參數(shù)格式

請求參數(shù)格式見表2。

表2請求參數(shù)格式

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

appId字符串首次注冊時，申請接入的平臺經(jīng)上級平臺審核通過后，由上級平臺統(tǒng)一返

回appId

timestamp整數(shù)Unix時間戳，請求發(fā)起時間，如果和系統(tǒng)時間相差超過10分鐘則會返回失

敗

sign字符串a(chǎn)pp憑證

其他請求參數(shù)/根據(jù)具體接口協(xié)議確定

5.1.5返回參數(shù)格式

返回參數(shù)格式見表3。

表3返回參數(shù)格式

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

successbool是否成功

errno整數(shù)錯誤碼，0為成功，其他為失敗，見5.1.6節(jié)狀態(tài)代碼

errmsg字符串錯誤信息

其他返回參數(shù)/根據(jù)具體應(yīng)用接口協(xié)議確定（處理成功后返回具體數(shù)據(jù)，否則為空）

注：第6章通信流程所涉及的各業(yè)務(wù)接口，如未明確定義返回參數(shù)，則默認返回success、errno、errmsg參數(shù)。

5.1.6狀態(tài)代碼

編碼規(guī)則：“0”代表成功，首位為“1”代表服務(wù)端錯誤，首位為“2”代表客戶端錯誤，具體錯

誤狀態(tài)代碼由“1”或“2”加三位排序號組成。具體狀態(tài)代碼及對應(yīng)說明見表4。

表4狀態(tài)代碼及說明

狀態(tài)代碼狀態(tài)說明

0成功

1001HTTP解析錯誤

1002HTTP請求參數(shù)錯誤

1003HTTP請求JSON解析錯誤

1004服務(wù)器處理失敗

5

DB36/T1296—2020

表4狀態(tài)代碼及說明（續(xù)）

狀態(tài)代碼狀態(tài)說明

1005請求頻率超限

1006數(shù)據(jù)更新（獲取）失敗

1007數(shù)據(jù)已存在,不能重復(fù)添加

1008數(shù)據(jù)不存在,不能修改

1009數(shù)據(jù)解析失敗

1010~預(yù)留

2001appId缺失

2002timestamp缺失

2003sign缺失

2004appId失效

2005timestamp失效

2006sign失效

2007必選參數(shù)缺失

2008~預(yù)留

5.2平臺管理規(guī)定

5.2.1注冊請求

首次接入時，縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺應(yīng)向上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺發(fā)

起注冊請求；消防管理服務(wù)平臺應(yīng)向本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺發(fā)起注冊請求。

5.2.2標識分配

收到注冊請求的城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺應(yīng)對接入注冊請求進行審批，審批通過后為接入的

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺或消防管理服務(wù)平臺分配唯一標識。

5.2.3平臺變更

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺進行平臺變更操作時，需要向上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)

應(yīng)用平臺進行報備審批；消防管理服務(wù)平臺進行平臺變更操作時，需要向本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)

用平臺進行報備審批。

5.3數(shù)據(jù)字典下載規(guī)定

5.3.1數(shù)據(jù)字典一致性

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺及消防管理服務(wù)平臺應(yīng)使用與省級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)

應(yīng)用平臺相同的數(shù)據(jù)字典。

5.3.2數(shù)據(jù)字典獲取方式

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺及消防管理服務(wù)平臺應(yīng)從省級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用

平臺獲取數(shù)據(jù)字典。

5.3.3數(shù)據(jù)字典下載要求

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺及消防管理服務(wù)平臺的數(shù)據(jù)字典下載應(yīng)符合本規(guī)范6.3

節(jié)相關(guān)要求。

5.4靜態(tài)數(shù)據(jù)上傳規(guī)定

5.4.1靜態(tài)數(shù)據(jù)上傳方向

6

DB36/T1296—2020

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺通過應(yīng)用接口上傳靜態(tài)數(shù)據(jù)至上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)

應(yīng)用平臺；消防管理服務(wù)平臺通過應(yīng)用接口上傳靜態(tài)數(shù)據(jù)至本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺。

5.4.2靜態(tài)數(shù)據(jù)上傳要求

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺向上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺，以及消防管理服

務(wù)平臺向本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺傳遞的靜態(tài)數(shù)據(jù)應(yīng)符合本規(guī)范6.4節(jié)相關(guān)要求。

5.5動態(tài)數(shù)據(jù)上傳規(guī)定

5.5.1動態(tài)數(shù)據(jù)上傳方向

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺通過應(yīng)用接口上傳動態(tài)數(shù)據(jù)至上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)

應(yīng)用平臺；消防管理服務(wù)平臺通過應(yīng)用接口上傳動態(tài)數(shù)據(jù)至本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺。

5.5.2動態(tài)數(shù)據(jù)上傳要求

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺向上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺，以及消防管理服

務(wù)平臺向本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺傳遞的動態(tài)數(shù)據(jù)應(yīng)符合本規(guī)范6.5節(jié)相關(guān)要求。

5.6操作數(shù)據(jù)上傳規(guī)定

5.6.1操作數(shù)據(jù)上傳方向

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺通過應(yīng)用接口上傳操作數(shù)據(jù)至上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)

應(yīng)用平臺；消防管理服務(wù)平臺通過應(yīng)用接口上傳操作數(shù)據(jù)至本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺。

5.6.2操作數(shù)據(jù)上傳要求

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺向上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺，以及消防管理服

務(wù)平臺向本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺傳遞的操作數(shù)據(jù)應(yīng)符合本規(guī)范6.6節(jié)相關(guān)要求。

5.7數(shù)據(jù)下發(fā)規(guī)定

上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺向縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺下發(fā)數(shù)據(jù)，或本級

城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺向消防管理服務(wù)平臺下發(fā)數(shù)據(jù)應(yīng)符合本規(guī)范第6章相關(guān)要求。

6通信流程

6.1流程概述

6.1.1平臺注冊及數(shù)據(jù)字典下載流程

首先由縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺及消防管理服務(wù)平臺向?qū)?yīng)的城市消防物聯(lián)網(wǎng)大數(shù)

據(jù)應(yīng)用平臺注冊，完成后向省級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺請求數(shù)據(jù)字典下載，見圖5。

7

DB36/T1296—2020

圖5平臺注冊及數(shù)據(jù)字典下載流程

6.1.2靜態(tài)數(shù)據(jù)上傳流程

靜態(tài)數(shù)據(jù)上傳包含靜態(tài)數(shù)據(jù)初始上傳和靜態(tài)數(shù)據(jù)變更上傳，見圖6。

開始

不通過，返回

CA認證

通過

靜態(tài)數(shù)據(jù)初始上傳靜態(tài)數(shù)據(jù)變更上傳

失敗，重新上傳失敗，重新上傳

返回碼驗證返回碼驗證

上傳成功上傳成功

完成

圖6靜態(tài)數(shù)據(jù)上傳流程

6.1.3動態(tài)數(shù)據(jù)上傳流程

動態(tài)數(shù)據(jù)上傳包含動態(tài)數(shù)據(jù)初始上傳和動態(tài)數(shù)據(jù)實時上傳，見圖7。

8

DB36/T1296—2020

開始

不通過，返回

CA認證

通過

動態(tài)數(shù)據(jù)初始上傳動態(tài)數(shù)據(jù)實時上傳

失敗，重新上傳失敗，重新上傳

返回碼驗證返回碼驗證

上傳成功上傳成功

完成

圖7動態(tài)數(shù)據(jù)上傳流程

6.1.4操作數(shù)據(jù)上傳流程

操作數(shù)據(jù)上傳包含操作數(shù)據(jù)初始上傳和操作數(shù)據(jù)實時上傳，見圖8。

開始

不通過，返回

CA認證

通過

操作數(shù)據(jù)初始上傳操作數(shù)據(jù)實時上傳

失敗，重新上傳失敗，重新上傳

返回碼驗證返回碼驗證

上傳成功上傳成功

完成

圖8操作數(shù)據(jù)上傳流程

6.2平臺管理流程

6.2.1平臺注冊及審批

首次接入時，縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺應(yīng)向上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺發(fā)

起注冊請求；消防管理服務(wù)平臺應(yīng)向本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺發(fā)起注冊請求。收到注冊請求

的城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺應(yīng)對接入注冊請求進行審批，審批通過后為接入的縣、市級城市消防

物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺或消防管理服務(wù)平臺分配唯一標識。

9

DB36/T1296—2020

6.2.2平臺變更

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺進行平臺變更操作時，需要向上級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)

應(yīng)用平臺進行報備審批；消防管理服務(wù)平臺進行平臺變更操作時，需要向本級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)

用平臺進行報備審批。

6.3數(shù)據(jù)字典下載流程

6.3.1數(shù)據(jù)字典配置信息

獲取數(shù)據(jù)字典內(nèi)容之前，縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺和消防管理服務(wù)平臺

應(yīng)首先獲取數(shù)據(jù)字典的配置信息。

接入的縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺和消防管理服務(wù)平臺根據(jù)獲取的配置信

息明確需要下載的數(shù)據(jù)字典內(nèi)容。

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺和消防管理服務(wù)平臺首次接入后應(yīng)根據(jù)省級城

市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺返回的清單，依次調(diào)用相關(guān)的API接口獲取數(shù)據(jù)字典信息。

a)訪問API：/api/v1/dictConfig/list；

b)請求參數(shù)：無；

c)返回參數(shù)：見表5；

d)參數(shù)dictConfig說明：見表6；

e)調(diào)用示例：參見附錄B.1。

表5數(shù)據(jù)字典配置返回參數(shù)

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

dictConfiglist需要下載的數(shù)據(jù)字典清單

表6參數(shù)dictConfig說明

list值說明

monitorCenter聯(lián)網(wǎng)單位相關(guān)信息-監(jiān)控中心

area聯(lián)網(wǎng)單位相關(guān)信息-行政區(qū)劃

industryType聯(lián)網(wǎng)單位相關(guān)信息-行業(yè)類別

fireManagement聯(lián)網(wǎng)單位相關(guān)信息-消防部門

orgType聯(lián)網(wǎng)單位相關(guān)信息-單位類別

monitorLevel聯(lián)網(wǎng)單位相關(guān)信息-監(jiān)管等級

monitorType聯(lián)網(wǎng)單位相關(guān)信息-監(jiān)管類型

economicOwnership聯(lián)網(wǎng)單位相關(guān)信息-經(jīng)濟所有制

buildingType建筑相關(guān)信息-建筑物類型

buildingNature建筑相關(guān)信息-建筑使用性質(zhì)

fireHazard建筑相關(guān)信息-火災(zāi)危險性

refractoryGrade建筑相關(guān)信息-耐火等級

buildingStructureType建筑相關(guān)信息-結(jié)構(gòu)類型

keyPartType建筑相關(guān)信息-重點部位類型

manufacturer設(shè)備類型-設(shè)備廠商

deviceType設(shè)備類型-設(shè)備類型

10

DB36/T1296—2020

表6參數(shù)dictConfig說明（續(xù)）

list值說明

commMode設(shè)備類型-通訊方式

tcqType點位-探測器類型

mnlType點位-模擬量類型

alarmCode報警類型

pictureType圖紙類型

fireSystem消防系統(tǒng)類型

縣、市級城市消防物聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺及消防管理服務(wù)平臺應(yīng)定期向省級城市消防物

聯(lián)網(wǎng)大數(shù)據(jù)應(yīng)用平臺請求獲取最新數(shù)據(jù)字典配置信息。

6.3.2聯(lián)網(wǎng)單位相關(guān)信息

監(jiān)控中心

監(jiān)控中心信息獲取方式如下：

a)根據(jù)中返回的清單獲取監(jiān)控中心編碼數(shù)據(jù)字典；

b)通過API訪問獲取當前所屬行政區(qū)劃所有的監(jiān)控中心名稱與監(jiān)控中心編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/monitorCenter/list；

d)請求參數(shù)：見表7（父級編碼為地市或區(qū)縣的編碼，請求包含父級編碼時，則返回請求的行政

區(qū)劃范圍內(nèi)監(jiān)控中心名稱與監(jiān)控中心編碼之間的對應(yīng)關(guān)系，若請求不包含父級編碼，則返回全

省范圍內(nèi)監(jiān)控中心名稱與監(jiān)控中心編碼之間的對應(yīng)關(guān)系）；

e)返回參數(shù)：見表8；

f)調(diào)用示例：參見附錄B.2。

表7監(jiān)控中心信息獲取請求參數(shù)

參數(shù)名稱參數(shù)類型是否必選說明

parentCodestring否父級編碼（編碼規(guī)則見附錄A.1）

表8監(jiān)控中心信息獲取返回參數(shù)

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

centerCodestring監(jiān)控中心編碼（編碼規(guī)則見附錄A.2）

centerNamestring監(jiān)控中心名稱

行政區(qū)劃信息

行政區(qū)劃信息獲取方式如下：

a)根據(jù)中返回的清單獲取行政區(qū)劃編碼數(shù)據(jù)字典；

b)通過API訪問獲取當前所屬行政區(qū)劃內(nèi)所有的地市區(qū)縣名稱與地市區(qū)縣編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/area/list；

d)請求參數(shù)：見表9（父級編碼為地市或區(qū)縣的編碼，請求包含父級編碼時，則返回請求的行政

區(qū)劃范圍內(nèi)地市區(qū)縣名稱與地市區(qū)縣編碼之間的對應(yīng)關(guān)系，若請求不包含父級編碼，則返回全

省范圍內(nèi)全部地市區(qū)縣名稱與地市區(qū)縣編碼之間的對應(yīng)關(guān)系）；

11

DB36/T1296—2020

e)返回參數(shù)：見表10；

f)調(diào)用示例：參見附錄B.3。

表9行政區(qū)劃信息獲取請求參數(shù)

參數(shù)名稱參數(shù)類型是否必選說明

parentCodestring否父級編碼（編碼規(guī)則見附錄A.1）

表10行政區(qū)劃信息獲取返回參數(shù)

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

areaCodestring行政區(qū)劃編碼（編碼規(guī)則見附錄A.1）

areaNamestring行政區(qū)劃名稱

areaTypestring行政區(qū)劃類型（1：國家；2：省份、直轄市；

3：地市；4：區(qū)縣）

行業(yè)類別

行業(yè)類別信息獲取方式如下：

a)根據(jù)中返回的清單獲取行業(yè)類別編碼數(shù)據(jù)字典；

b)通過API訪問獲取當行業(yè)類別名稱與行業(yè)類別編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/industryType/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表11；

f)調(diào)用示例：見附錄B.4。

表11行業(yè)類別信息獲取返回參數(shù)

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

industryCodestring行業(yè)類別編碼（編碼規(guī)則見附錄A.3）

industryNamestring行業(yè)類別名稱

消防部門

消防部門信息獲取方式如下：

a)根據(jù)中返回的清單獲取消防部門編碼數(shù)據(jù)字典；‘

b)通過API訪問獲取當前所屬行政區(qū)劃所有的消防部門名稱與消防部門編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/fireManagement/list；

d)請求參數(shù)：見表12（父級編碼為地市或區(qū)縣的編碼，請求包含父級編碼時，則返回請求的行

政區(qū)劃范圍內(nèi)消防部門名稱與消防部門編碼之間的對應(yīng)關(guān)系，若請求不包含父級編碼，則返回

全省范圍內(nèi)消防部門名稱與消防部門編碼之間的對應(yīng)關(guān)系）；

e)返回參數(shù)：見表13；

f)調(diào)用示例：參見附錄B.5。

表12消防部門信息獲取請求參數(shù)

參數(shù)名稱參數(shù)類型是否必選說明

parentCodestring否父級編碼（編碼規(guī)則見附錄A.3）

12

DB36/T1296—2020

表13消防部門信息獲取返回參數(shù)

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

fireManagementCodestring消防部門編碼（編碼規(guī)則見附錄A.4）

fireManagementNamestring消防部門名稱

單位類別

單位類別信息獲取方式如下：

a)根據(jù)中返回的清單獲取單位類別編碼數(shù)據(jù)字典；

b)通過API訪問獲取單位類別名稱與單位類別編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/orgType/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表14；

f)調(diào)用示例:參見附錄B.6。

表14單位類別信息獲取返回參數(shù)

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

orgTypeCodestring單位類別編碼（編碼規(guī)則見附錄A.5）

orgTypeNamestring單位類別名稱

監(jiān)管等級

監(jiān)管等級信息獲取方式如下：

a)根據(jù)中返回的清單獲取監(jiān)管等級編碼數(shù)據(jù)字典；

b)通過API訪問獲取監(jiān)管等級名稱與監(jiān)管等級編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/monitorLevel/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表15；

f)調(diào)用示例：參加附錄B.7。

表15監(jiān)管等級信息獲取返回參數(shù)

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

monitorLevelCodestring監(jiān)管等級編碼（編碼規(guī)則見附錄A.6）

monitorLevelNamestring監(jiān)管等級名稱

監(jiān)管類別

監(jiān)管類別信息獲取方式如下：

a)根據(jù)中返回的清單獲取監(jiān)管類別編碼數(shù)據(jù)字典；

b)通過API訪問獲取監(jiān)管類別名稱與監(jiān)管類別編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/monitorType/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表16；

f)調(diào)用示例：參見附錄B.8。

13

DB36/T1296—2020

表16監(jiān)管類別信息獲取返回參數(shù)

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

monitorTypeCodestring監(jiān)管類別編碼（編碼規(guī)則見附錄A.7）

monitorTypeNamestring監(jiān)管類別名稱

經(jīng)濟所有制

經(jīng)濟所有制信息獲取方式如下：

a)根據(jù)中返回的清單獲取經(jīng)濟所有制編碼數(shù)據(jù)字典；

b)通過API訪問獲取經(jīng)濟所有制名稱與經(jīng)濟所有制編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/economicOwnership/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表17；

f)調(diào)用示例：參見附錄B.9。

表17經(jīng)濟所有制信息獲取返回參數(shù)

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

economicOwnershipCodestring經(jīng)濟所有制編碼（編碼規(guī)則見附錄A.8）

economicOwnershipNamestring經(jīng)濟所有制名稱

6.3.3建筑相關(guān)信息

建筑物類型

建筑物類型信息獲取方式如下：

a)根據(jù)中返回的清單獲取建筑物類型編碼數(shù)據(jù)字典；

b)通過API訪問獲取建筑物類型名稱與建筑物類型編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/buildingType/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表18；

f)調(diào)用示例：參見附錄B.10。

表18建筑物類型信息獲取返回參數(shù)

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

buildingTypeCodestring建筑物類型編碼（編碼規(guī)則見附錄A.9）

buildingTypeNamestring建筑物類型名稱

建筑使用性質(zhì)

建筑使用性質(zhì)信息獲取方式如下：

a)根據(jù)中返回的清單獲取建筑使用性質(zhì)編碼數(shù)據(jù)字典；

b)通過API訪問獲取建筑使用性質(zhì)名稱與建筑使用性質(zhì)編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/buildingNature/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表19；

f)調(diào)用示例:參見附錄B.11。

14

DB36/T1296—2020

表19建筑使用性質(zhì)信息獲取返回參數(shù)

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

buildingNatureCodestring建筑使用性質(zhì)編碼（編碼規(guī)則見附錄A.10）

buildingNatureNamestring建筑使用性質(zhì)名稱

火災(zāi)危險性

火災(zāi)危險性信息獲取方式如下：

a)根據(jù)中返回的清單獲取火災(zāi)危險性編碼數(shù)據(jù)字典；

b)通過API訪問獲取火災(zāi)危險性名稱與火災(zāi)危險性編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/fireHazard/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表20；

f)調(diào)用示例：參見附錄B.12。

表20火災(zāi)危險性信息獲取返回參數(shù)

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

fireHazardCodestring火災(zāi)危險性編碼（編碼規(guī)則見附錄A.11）

fireHazardNamestring火災(zāi)危險性名稱

耐火等級

耐火等級信息獲取方式如下：

a)根據(jù)中返回的清單獲取耐火等級編碼數(shù)據(jù)字典；

b)通過API訪問獲取耐火等級名稱與耐火等級編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/refractoryGrade/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表21；

f)調(diào)用示例：參見附錄B.13。

表21耐火等級信息獲取返回參數(shù)

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

refractoryGradeCodestring耐火等級編碼（編碼規(guī)則見附錄A.12）

refractoryGradeNamestring耐火等級名稱

結(jié)構(gòu)類型

結(jié)構(gòu)類型信息獲取方式如下：

a)根據(jù)中返回的清單獲取結(jié)構(gòu)類型編碼數(shù)據(jù)字典；

b)通過API訪問獲取結(jié)構(gòu)類型名稱與結(jié)構(gòu)類型編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/buildingStructType/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表22；

f)調(diào)用示例：參見附錄B.14。

15

DB36/T1296—2020

表22結(jié)構(gòu)類型信息獲取返回參數(shù)

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

buildingStructTypeCodestring結(jié)構(gòu)類型編碼（編碼規(guī)則見附錄A.13）

buildingStructTypeNamestring結(jié)構(gòu)類型名稱

重點部位類型

重點部位類型信息獲取方式如下：

a)根據(jù)中返回的清單獲取重點部位類型編碼數(shù)據(jù)字典；

b)通過API訪問獲取重點部位類型名稱與重點部位類型編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/keyPartType/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表23；

f)調(diào)用示例:參見附錄B.15。

表23重點部位類型信息獲取返回參數(shù)

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

keyPartTypeCodestring重點部位類型編碼（編碼規(guī)則見附錄A.14）

keyPartTypeNamestring重點部位類型名稱

6.3.4設(shè)備類型

設(shè)備廠商

設(shè)備廠商信息獲取方式如下：

a)根據(jù)中返回的清單獲取設(shè)備廠商編碼數(shù)據(jù)字典；

b)通過API訪問獲取設(shè)備廠商名稱與設(shè)備廠商編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/manufacturer/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表24；

f)調(diào)用示例：參見附錄B.16。

表24設(shè)備廠商信息獲取返回參數(shù)

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

manufacturerCodestring廠商編碼（編碼規(guī)則見附錄A.15）

manufacturerNamestring廠商名稱

設(shè)備型號

設(shè)備型號信息獲取方式如下：

a)根據(jù)中返回的清單獲取設(shè)備型號數(shù)據(jù)字典；

b)通過API訪問獲取設(shè)備型號與設(shè)備類型編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/deviceType/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表25；

f)調(diào)用示例：參見附錄B.17。

16

DB36/T1296—2020

表25設(shè)備型號信息獲取返回參數(shù)

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

deviceTypestring設(shè)備型號

manufacturerCodestring廠商編碼（編碼規(guī)則見附錄A.15）

deviceCodestring設(shè)備類型編碼（編碼規(guī)則見附錄A.16）

deviceCodeNamestring設(shè)備類型名稱

設(shè)備通訊方式

設(shè)備通訊方式信息獲取方式如下：

a)根據(jù)中返回的清單獲取設(shè)備通訊方式數(shù)據(jù)字典；

b)通過API訪問獲取通訊方式名稱與通訊方式編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/commMode/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表26；

f)調(diào)用示例：參見附錄B.18。

表26設(shè)備通訊方式信息獲取返回參數(shù)

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

commModeCodestring通訊方式編碼（編碼規(guī)則見附錄A.17）

commModeNamestring通訊方式名稱

6.3.5點位相關(guān)信息

探測器類型

探測器類型信息獲取方式如下：

a)根據(jù)中返回的清單獲取探測器類型數(shù)據(jù)字典；

b)通過API訪問獲取探測器類型名稱與探測器類型編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/tcqType/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表27；

f)調(diào)用示例：參見附錄B.19。

表27探測器類型信息獲取返回參數(shù)

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

detectorTypeCodestring探測器類型編碼（編碼規(guī)則見附錄A.18）

detectorTypeNamestring探測器類型名稱

模擬量類型

模擬量類型信息獲取方式如下：

a)根據(jù)中返回的清單獲取模擬量類型數(shù)據(jù)字典；

b)通過API訪問獲取模擬量類型名稱與模擬量類型編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/mnlType/list；

d)請求參數(shù)：無；

17

DB36/T1296—2020

e)返回參數(shù)：見表28；

f)調(diào)用示例：參見附錄B.20。

表28模擬量類型信息獲取返回參數(shù)

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

mnltypeCodestring模擬量類型編碼（編碼規(guī)則見附錄A.19）

mnltypeNamestring模擬量類型名稱

unitstring單位

minMeteringstring最小值

6.3.6報警類型

報警類型信息獲取方式如下：

a)根據(jù)中返回的清單獲取報警類型數(shù)據(jù)字典；

b)通過API訪問獲取報警類型與報警類型編碼之間的對應(yīng)關(guān)系；

c)請求API：/api/v1/alarmCode/list；

d)請求參數(shù)：無；

e)返回參數(shù)：見表29；

f)調(diào)用示例：參見附錄B.21。

表29報警類型信息獲取返回參數(shù)

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

alarmCodestring報警類型編碼（編碼規(guī)則見附錄A.20）

alarmTypestring報警類型

6.3.7圖紙類型

圖紙類型信息獲取方式如下：

a)根據(jù)中返回的清單獲取圖紙類型數(shù)據(jù)字典；

b)通過API訪問獲取圖紙類型名稱與圖紙類型編碼之間的對應(yīng)關(guān)系