DB36∕T 1296-2020 城市消防物聯網大數據應用平臺接口規范

ICS35.240.01

L70

DB36

江西省地方標準

DB36/T1296—2020

城市消防物聯網大數據應用平臺接口規范

InterfacespecificationforurbanfireIoTbigdataapplicationplatform

2020-XX-XX發布2020-XX-XX實施

江西省市場監督管理局發布

DB36/T1296—2020

目次

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

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

2規范性引用文件..........................................................................................................................................1

3術語和定義..................................................................................................................................................1

4體系架構及協議層次..................................................................................................................................3

5應用協議......................................................................................................................................................4

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

附錄A（規范性附錄）編碼信息................................................................................................................43

附錄B（資料性附錄）調用示例................................................................................................................60

本規程用詞說明............................................................................................................................................122

I

DB36/T1296—2020

前言

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

本規范的某些內容可能涉及專利，本文件發布機構不應承擔識別這些專利的責任。

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

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

本規范參編單位：中國電信集團有限公司江西分公司、中國移動通信集團公司江西分公司、中國聯

合網絡通信集團有限公司江西省分公司、南昌航空大學軟件學院院。

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

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

傅強。

II

DB36/T1296—2020

城市消防物聯網大數據應用平臺接口規范

1范圍

本規范用于規定本省范圍內省、市、縣級城市消防物聯網大數據應用平臺之間，以及城市消防物聯

網大數據應用平臺與社會單位、行業部門等其他消防管理服務平臺之間的數據交換。

本規范規定了數據交換過程的應用層通信協議。

2規范性引用文件

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

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

GB/T4754-2017國民經濟分類

GB/T12402-2000經濟類型分類與代碼

GB12955-2015防火門

GB14287-2014（所有部分）電氣火災監控系統

GB16806-2006消防聯動控制系統

GB/T22239-2019信息安全技術網絡安全等級保護基本要求

GB25201-2010建筑消防設施的維護管理

GB25506-2010消防控制室通用技術要求

GB25972-2010氣體滅火系統及部件

GB/T26875.3-2011城市消防遠程監控系統第3部分：報警傳輸網絡通信協議

GB/T26875.4-2011城市消防遠程監控系統第4部分：基礎數據項

GB/T30269.701-2014信息技術傳感器網絡第701部分：傳感器接口：信號接口

GB50016-2014建筑設計防火規范

GB50084-2017自動噴水滅火系統設計規范

GB50116-2013火災自動報警系統設計規范

GB50166-2019火災自動報警系統施工及驗收規范

GB50219-2014水噴霧滅火系統設計規范

GB50261-2017自動噴水滅火系統施工及驗收規范

GB50370-2005氣體滅火系統設計規范

GA/T396-2002消防業務基礎數據元與代碼表

GA/T1038.1-2012消防公共服務平臺技術規范第1部分：總體架構及功能要求

GA/T1038.2-2012消防公共服務平臺技術規范第2部分：服務管理接口

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

GM/T0054-2018信息系統密碼應用基本要求

3術語和定義

1

DB36/T1296—2020

下列術語和定義適用于本規范。

3.1

城市消防物聯網大數據應用平臺urbanfireIoTbigdataapplicationplatform

由政府統一建設的用于消防監督管理的消防大數據應用平臺，按照行政區劃劃分為省級、市級、縣

級等，服務于各級消防部門、行業部門、消防單位、維保、設備等消防產業企業。

3.2

消防管理服務平臺managementplatformofFIoT

由社會單位建設的，負責信息感知設備的接入、管理、控制并提供相關基礎應用服務的平臺。

3.3

平臺管理platformmanagement

由政府統一建設的縣、市級城市消防物聯網大數據應用平臺需要通過訪問上級城市消防物聯網大數

據應用平臺相關接口，完成平臺的注冊、變更等管理操作。社會單位建設的消防管理服務平臺需要通過

訪問本級城市消防物聯網大數據應用平臺相關接口，完成平臺的注冊、變更等管理操作。

3.4

數據字典下載datadictionarydownload

縣、市級城市消防物聯網大數據應用平臺和消防管理服務平臺完成注冊后需要從省級城市消防物聯

網大數據應用平臺中下載數據字典，以保證各類數據統一編碼。

3.5

靜態數據上傳staticdataupload

縣、市級城市消防物聯網大數據應用平臺擁有的靜態數據向上級城市消防物聯網大數據應用平臺進

行數據傳輸，消防管理服務平臺擁有的靜態數據向本級城市消防物聯網大數據應用平臺進行數據傳輸。

3.6

動態數據上傳dynamicdataupload

縣、市級城市消防物聯網大數據應用平臺擁有的動態數據向上級城市消防物聯網大數據應用平臺進

行數據傳輸，消防管理服務平臺擁有的動態數據向本級城市消防物聯網大數據應用平臺進行數據傳輸。

3.7

操作數據上傳operationdataupload

縣、市級城市消防物聯網大數據應用平臺擁有的操作數據向上級城市消防物聯網大數據應用平臺進

行數據傳輸，消防管理服務平臺擁有的操作數據向本級城市消防物聯網大數據應用平臺進行數據傳輸。

3.8

數據下發datadownlink

2

DB36/T1296—2020

省、市、縣級城市消防物聯網大數據應用平臺根據業務需求下傳各類消防數據。

4體系架構及協議層次

4.1體系架構

省、市、縣級政府消防物聯網大數據應用平臺間及本級城市消防物聯網大數據應用平臺與消防管理

服務平臺之間的邏輯架構如圖1所示。

圖1體系架構

4.2協議層次與安全要求

4.2.1省、市級城市消防物聯網大數據應用平臺與市、縣級城市消防物聯網大數據應用平臺之間的協

議關系如圖2所示。

圖2協議層次

4.2.2消防管理服務平臺與本級城市消防物聯網大數據應用平臺之間的協議關系如圖3所示。

3

DB36/T1296—2020

圖3協議層次

4.2.3城市消防物聯網大數據應用平臺應通過身份認證、傳輸加密、數據校驗等方式確保數據傳輸的

安全性，并應符合GB/T22239-2019、GM/T0054-2018等相關規定。

5應用協議

5.1一般規定

5.1.1身份驗證

省、市、縣級城市消防物聯網大數據應用平臺間，以及消防管理服務平臺與本級城市消防物聯網大

數據應用平臺間進行數據交互時，需采用統一要求的CA數字證書進行身份驗證。

5.1.2應用接口協議

省、市、縣級城市消防物聯網大數據應用平臺間，以及消防管理服務平臺與本級城市消防物聯網大

數據應用平臺間的應用接口協議包含平臺管理、數據字典下載、靜態數據上傳、動態數據上傳、操作數

據上傳、數據下發等協議，具體框架見圖4。

圖4應用接口協議

5.1.3應用接口協議格式

應用接口協議格式見表1。

4

DB36/T1296—2020

表1應用接口協議格式

協議POST

編碼格式UTF-8

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

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

各業務接口定義。

5.1.4請求參數格式

請求參數格式見表2。

表2請求參數格式

參數名稱類型說明

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

回appId

timestamp整數Unix時間戳，請求發起時間，如果和系統時間相差超過10分鐘則會返回失

敗

sign字符串app憑證

其他請求參數/根據具體接口協議確定

5.1.5返回參數格式

返回參數格式見表3。

表3返回參數格式

參數名稱類型說明

successbool是否成功

errno整數錯誤碼，0為成功，其他為失敗，見5.1.6節狀態代碼

errmsg字符串錯誤信息

其他返回參數/根據具體應用接口協議確定（處理成功后返回具體數據，否則為空）

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

5.1.6狀態代碼

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

誤狀態代碼由“1”或“2”加三位排序號組成。具體狀態代碼及對應說明見表4。

表4狀態代碼及說明

狀態代碼狀態說明

0成功

1001HTTP解析錯誤

1002HTTP請求參數錯誤

1003HTTP請求JSON解析錯誤

1004服務器處理失敗

5

DB36/T1296—2020

表4狀態代碼及說明（續）

狀態代碼狀態說明

1005請求頻率超限

1006數據更新（獲取）失敗

1007數據已存在,不能重復添加

1008數據不存在,不能修改

1009數據解析失敗

1010~預留

2001appId缺失

2002timestamp缺失

2003sign缺失

2004appId失效

2005timestamp失效

2006sign失效

2007必選參數缺失

2008~預留

5.2平臺管理規定

5.2.1注冊請求

首次接入時，縣、市級城市消防物聯網大數據應用平臺應向上級城市消防物聯網大數據應用平臺發

起注冊請求；消防管理服務平臺應向本級城市消防物聯網大數據應用平臺發起注冊請求。

5.2.2標識分配

收到注冊請求的城市消防物聯網大數據應用平臺應對接入注冊請求進行審批，審批通過后為接入的

縣、市級城市消防物聯網大數據應用平臺或消防管理服務平臺分配唯一標識。

5.2.3平臺變更

縣、市級城市消防物聯網大數據應用平臺進行平臺變更操作時，需要向上級城市消防物聯網大數據

應用平臺進行報備審批；消防管理服務平臺進行平臺變更操作時，需要向本級城市消防物聯網大數據應

用平臺進行報備審批。

5.3數據字典下載規定

5.3.1數據字典一致性

縣、市級城市消防物聯網大數據應用平臺及消防管理服務平臺應使用與省級城市消防物聯網大數據

應用平臺相同的數據字典。

5.3.2數據字典獲取方式

縣、市級城市消防物聯網大數據應用平臺及消防管理服務平臺應從省級城市消防物聯網大數據應用

平臺獲取數據字典。

5.3.3數據字典下載要求

縣、市級城市消防物聯網大數據應用平臺及消防管理服務平臺的數據字典下載應符合本規范6.3

節相關要求。

5.4靜態數據上傳規定

5.4.1靜態數據上傳方向

6

DB36/T1296—2020

縣、市級城市消防物聯網大數據應用平臺通過應用接口上傳靜態數據至上級城市消防物聯網大數據

應用平臺；消防管理服務平臺通過應用接口上傳靜態數據至本級城市消防物聯網大數據應用平臺。

5.4.2靜態數據上傳要求

縣、市級城市消防物聯網大數據應用平臺向上級城市消防物聯網大數據應用平臺，以及消防管理服

務平臺向本級城市消防物聯網大數據應用平臺傳遞的靜態數據應符合本規范6.4節相關要求。

5.5動態數據上傳規定

5.5.1動態數據上傳方向

縣、市級城市消防物聯網大數據應用平臺通過應用接口上傳動態數據至上級城市消防物聯網大數據

應用平臺；消防管理服務平臺通過應用接口上傳動態數據至本級城市消防物聯網大數據應用平臺。

5.5.2動態數據上傳要求

縣、市級城市消防物聯網大數據應用平臺向上級城市消防物聯網大數據應用平臺，以及消防管理服

務平臺向本級城市消防物聯網大數據應用平臺傳遞的動態數據應符合本規范6.5節相關要求。

5.6操作數據上傳規定

5.6.1操作數據上傳方向

縣、市級城市消防物聯網大數據應用平臺通過應用接口上傳操作數據至上級城市消防物聯網大數據

應用平臺；消防管理服務平臺通過應用接口上傳操作數據至本級城市消防物聯網大數據應用平臺。

5.6.2操作數據上傳要求

縣、市級城市消防物聯網大數據應用平臺向上級城市消防物聯網大數據應用平臺，以及消防管理服

務平臺向本級城市消防物聯網大數據應用平臺傳遞的操作數據應符合本規范6.6節相關要求。

5.7數據下發規定

上級城市消防物聯網大數據應用平臺向縣、市級城市消防物聯網大數據應用平臺下發數據，或本級

城市消防物聯網大數據應用平臺向消防管理服務平臺下發數據應符合本規范第6章相關要求。

6通信流程

6.1流程概述

6.1.1平臺注冊及數據字典下載流程

首先由縣、市級城市消防物聯網大數據應用平臺及消防管理服務平臺向對應的城市消防物聯網大數

據應用平臺注冊，完成后向省級城市消防物聯網大數據應用平臺請求數據字典下載，見圖5。

7

DB36/T1296—2020

圖5平臺注冊及數據字典下載流程

6.1.2靜態數據上傳流程

靜態數據上傳包含靜態數據初始上傳和靜態數據變更上傳，見圖6。

開始

不通過，返回

CA認證

通過

靜態數據初始上傳靜態數據變更上傳

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

返回碼驗證返回碼驗證

上傳成功上傳成功

完成

圖6靜態數據上傳流程

6.1.3動態數據上傳流程

動態數據上傳包含動態數據初始上傳和動態數據實時上傳，見圖7。

8

DB36/T1296—2020

開始

不通過，返回

CA認證

通過

動態數據初始上傳動態數據實時上傳

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

返回碼驗證返回碼驗證

上傳成功上傳成功

完成

圖7動態數據上傳流程

6.1.4操作數據上傳流程

操作數據上傳包含操作數據初始上傳和操作數據實時上傳，見圖8。

開始

不通過，返回

CA認證

通過

操作數據初始上傳操作數據實時上傳

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

返回碼驗證返回碼驗證

上傳成功上傳成功

完成

圖8操作數據上傳流程

6.2平臺管理流程

6.2.1平臺注冊及審批

首次接入時，縣、市級城市消防物聯網大數據應用平臺應向上級城市消防物聯網大數據應用平臺發

起注冊請求；消防管理服務平臺應向本級城市消防物聯網大數據應用平臺發起注冊請求。收到注冊請求

的城市消防物聯網大數據應用平臺應對接入注冊請求進行審批，審批通過后為接入的縣、市級城市消防

物聯網大數據應用平臺或消防管理服務平臺分配唯一標識。

9

DB36/T1296—2020

6.2.2平臺變更

縣、市級城市消防物聯網大數據應用平臺進行平臺變更操作時，需要向上級城市消防物聯網大數據

應用平臺進行報備審批；消防管理服務平臺進行平臺變更操作時，需要向本級城市消防物聯網大數據應

用平臺進行報備審批。

6.3數據字典下載流程

6.3.1數據字典配置信息

獲取數據字典內容之前，縣、市級城市消防物聯網大數據應用平臺和消防管理服務平臺

應首先獲取數據字典的配置信息。

接入的縣、市級城市消防物聯網大數據應用平臺和消防管理服務平臺根據獲取的配置信

息明確需要下載的數據字典內容。

縣、市級城市消防物聯網大數據應用平臺和消防管理服務平臺首次接入后應根據省級城

市消防物聯網大數據應用平臺返回的清單，依次調用相關的API接口獲取數據字典信息。

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

b)請求參數：無；

c)返回參數：見表5；

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

e)調用示例：參見附錄B.1。

表5數據字典配置返回參數

參數名稱參數類型說明

dictConfiglist需要下載的數據字典清單

表6參數dictConfig說明

list值說明

monitorCenter聯網單位相關信息-監控中心

area聯網單位相關信息-行政區劃

industryType聯網單位相關信息-行業類別

fireManagement聯網單位相關信息-消防部門

orgType聯網單位相關信息-單位類別

monitorLevel聯網單位相關信息-監管等級

monitorType聯網單位相關信息-監管類型

economicOwnership聯網單位相關信息-經濟所有制

buildingType建筑相關信息-建筑物類型

buildingNature建筑相關信息-建筑使用性質

fireHazard建筑相關信息-火災危險性

refractoryGrade建筑相關信息-耐火等級

buildingStructureType建筑相關信息-結構類型

keyPartType建筑相關信息-重點部位類型

manufacturer設備類型-設備廠商

deviceType設備類型-設備類型

10

DB36/T1296—2020

表6參數dictConfig說明（續）

list值說明

commMode設備類型-通訊方式

tcqType點位-探測器類型

mnlType點位-模擬量類型

alarmCode報警類型

pictureType圖紙類型

fireSystem消防系統類型

縣、市級城市消防物聯網大數據應用平臺及消防管理服務平臺應定期向省級城市消防物

聯網大數據應用平臺請求獲取最新數據字典配置信息。

6.3.2聯網單位相關信息

監控中心

監控中心信息獲取方式如下：

a)根據中返回的清單獲取監控中心編碼數據字典；

b)通過API訪問獲取當前所屬行政區劃所有的監控中心名稱與監控中心編碼之間的對應關系；

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

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

區劃范圍內監控中心名稱與監控中心編碼之間的對應關系，若請求不包含父級編碼，則返回全

省范圍內監控中心名稱與監控中心編碼之間的對應關系）；

e)返回參數：見表8；

f)調用示例：參見附錄B.2。

表7監控中心信息獲取請求參數

參數名稱參數類型是否必選說明

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

表8監控中心信息獲取返回參數

參數名稱參數類型說明

centerCodestring監控中心編碼（編碼規則見附錄A.2）

centerNamestring監控中心名稱

行政區劃信息

行政區劃信息獲取方式如下：

a)根據中返回的清單獲取行政區劃編碼數據字典；

b)通過API訪問獲取當前所屬行政區劃內所有的地市區縣名稱與地市區縣編碼之間的對應關系；

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

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

區劃范圍內地市區縣名稱與地市區縣編碼之間的對應關系，若請求不包含父級編碼，則返回全

省范圍內全部地市區縣名稱與地市區縣編碼之間的對應關系）；

11

DB36/T1296—2020

e)返回參數：見表10；

f)調用示例：參見附錄B.3。

表9行政區劃信息獲取請求參數

參數名稱參數類型是否必選說明

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

表10行政區劃信息獲取返回參數

參數名稱參數類型說明

areaCodestring行政區劃編碼（編碼規則見附錄A.1）

areaNamestring行政區劃名稱

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

3：地市；4：區縣）

行業類別

行業類別信息獲取方式如下：

a)根據中返回的清單獲取行業類別編碼數據字典；

b)通過API訪問獲取當行業類別名稱與行業類別編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表11；

f)調用示例：見附錄B.4。

表11行業類別信息獲取返回參數

參數名稱參數類型說明

industryCodestring行業類別編碼（編碼規則見附錄A.3）

industryNamestring行業類別名稱

消防部門

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

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

b)通過API訪問獲取當前所屬行政區劃所有的消防部門名稱與消防部門編碼之間的對應關系；

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

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

政區劃范圍內消防部門名稱與消防部門編碼之間的對應關系，若請求不包含父級編碼，則返回

全省范圍內消防部門名稱與消防部門編碼之間的對應關系）；

e)返回參數：見表13；

f)調用示例：參見附錄B.5。

表12消防部門信息獲取請求參數

參數名稱參數類型是否必選說明

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

12

DB36/T1296—2020

表13消防部門信息獲取返回參數

參數名稱參數類型說明

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

fireManagementNamestring消防部門名稱

單位類別

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

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

b)通過API訪問獲取單位類別名稱與單位類別編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表14；

f)調用示例:參見附錄B.6。

表14單位類別信息獲取返回參數

參數名稱參數類型說明

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

orgTypeNamestring單位類別名稱

監管等級

監管等級信息獲取方式如下：

a)根據中返回的清單獲取監管等級編碼數據字典；

b)通過API訪問獲取監管等級名稱與監管等級編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表15；

f)調用示例：參加附錄B.7。

表15監管等級信息獲取返回參數

參數名稱參數類型說明

monitorLevelCodestring監管等級編碼（編碼規則見附錄A.6）

monitorLevelNamestring監管等級名稱

監管類別

監管類別信息獲取方式如下：

a)根據中返回的清單獲取監管類別編碼數據字典；

b)通過API訪問獲取監管類別名稱與監管類別編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表16；

f)調用示例：參見附錄B.8。

13

DB36/T1296—2020

表16監管類別信息獲取返回參數

參數名稱參數類型說明

monitorTypeCodestring監管類別編碼（編碼規則見附錄A.7）

monitorTypeNamestring監管類別名稱

經濟所有制

經濟所有制信息獲取方式如下：

a)根據中返回的清單獲取經濟所有制編碼數據字典；

b)通過API訪問獲取經濟所有制名稱與經濟所有制編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表17；

f)調用示例：參見附錄B.9。

表17經濟所有制信息獲取返回參數

參數名稱參數類型說明

economicOwnershipCodestring經濟所有制編碼（編碼規則見附錄A.8）

economicOwnershipNamestring經濟所有制名稱

6.3.3建筑相關信息

建筑物類型

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

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

b)通過API訪問獲取建筑物類型名稱與建筑物類型編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表18；

f)調用示例：參見附錄B.10。

表18建筑物類型信息獲取返回參數

參數名稱參數類型說明

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

buildingTypeNamestring建筑物類型名稱

建筑使用性質

建筑使用性質信息獲取方式如下：

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

b)通過API訪問獲取建筑使用性質名稱與建筑使用性質編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表19；

f)調用示例:參見附錄B.11。

14

DB36/T1296—2020

表19建筑使用性質信息獲取返回參數

參數名稱參數類型說明

buildingNatureCodestring建筑使用性質編碼（編碼規則見附錄A.10）

buildingNatureNamestring建筑使用性質名稱

火災危險性

火災危險性信息獲取方式如下：

a)根據中返回的清單獲取火災危險性編碼數據字典；

b)通過API訪問獲取火災危險性名稱與火災危險性編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表20；

f)調用示例：參見附錄B.12。

表20火災危險性信息獲取返回參數

參數名稱參數類型說明

fireHazardCodestring火災危險性編碼（編碼規則見附錄A.11）

fireHazardNamestring火災危險性名稱

耐火等級

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

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

b)通過API訪問獲取耐火等級名稱與耐火等級編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表21；

f)調用示例：參見附錄B.13。

表21耐火等級信息獲取返回參數

參數名稱參數類型說明

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

refractoryGradeNamestring耐火等級名稱

結構類型

結構類型信息獲取方式如下：

a)根據中返回的清單獲取結構類型編碼數據字典；

b)通過API訪問獲取結構類型名稱與結構類型編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表22；

f)調用示例：參見附錄B.14。

15

DB36/T1296—2020

表22結構類型信息獲取返回參數

參數名稱參數類型說明

buildingStructTypeCodestring結構類型編碼（編碼規則見附錄A.13）

buildingStructTypeNamestring結構類型名稱

重點部位類型

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

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

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

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

d)請求參數：無；

e)返回參數：見表23；

f)調用示例:參見附錄B.15。

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

參數名稱參數類型說明

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

keyPartTypeNamestring重點部位類型名稱

6.3.4設備類型

設備廠商

設備廠商信息獲取方式如下：

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

b)通過API訪問獲取設備廠商名稱與設備廠商編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表24；

f)調用示例：參見附錄B.16。

表24設備廠商信息獲取返回參數

參數名稱參數類型說明

manufacturerCodestring廠商編碼（編碼規則見附錄A.15）

manufacturerNamestring廠商名稱

設備型號

設備型號信息獲取方式如下：

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

b)通過API訪問獲取設備型號與設備類型編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表25；

f)調用示例：參見附錄B.17。

16

DB36/T1296—2020

表25設備型號信息獲取返回參數

參數名稱參數類型說明

deviceTypestring設備型號

manufacturerCodestring廠商編碼（編碼規則見附錄A.15）

deviceCodestring設備類型編碼（編碼規則見附錄A.16）

deviceCodeNamestring設備類型名稱

設備通訊方式

設備通訊方式信息獲取方式如下：

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

b)通過API訪問獲取通訊方式名稱與通訊方式編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表26；

f)調用示例：參見附錄B.18。

表26設備通訊方式信息獲取返回參數

參數名稱參數類型說明

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

commModeNamestring通訊方式名稱

6.3.5點位相關信息

探測器類型

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

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

b)通過API訪問獲取探測器類型名稱與探測器類型編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表27；

f)調用示例：參見附錄B.19。

表27探測器類型信息獲取返回參數

參數名稱參數類型說明

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

detectorTypeNamestring探測器類型名稱

模擬量類型

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

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

b)通過API訪問獲取模擬量類型名稱與模擬量類型編碼之間的對應關系；

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

d)請求參數：無；

17

DB36/T1296—2020

e)返回參數：見表28；

f)調用示例：參見附錄B.20。

表28模擬量類型信息獲取返回參數

參數名稱參數類型說明

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

mnltypeNamestring模擬量類型名稱

unitstring單位

minMeteringstring最小值

6.3.6報警類型

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

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

b)通過API訪問獲取報警類型與報警類型編碼之間的對應關系；

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

d)請求參數：無；

e)返回參數：見表29；

f)調用示例：參見附錄B.21。

表29報警類型信息獲取返回參數

參數名稱參數類型說明

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

alarmTypestring報警類型

6.3.7圖紙類型

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

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

b)通過API訪問獲取圖紙類型名稱與圖紙類型編碼之間的對應關系