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监管类别名称