(高清版）DB36_T 1296-2021城市消防物联网大数据应用平台接口规范.pdf

ICS 35.240.01 L 70 DB36 江西省地方标准 DB36/T 12962020 城市消防物联网大数据应用平台接口规范 Interface specification for urban fire IoT big data application platform 2020-XX-XX 发布 2020-XX-XX 实施 江西省市场监督管理局 发 布 DB36/T 12962020 I 目 次 前 言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 体系架构及协议层次.3 5 应用协议.4 6 通信流程.7 附录 A（规范性附录）编码信息.43 附录 B（资料性附录）调用示例.60 本规程用词说明.122 DB36/T 12962020 II 前 言 本规范按照GB/T 1.1-2020的规定起草。本规范的某些内容可能涉及专利，本文件发布机构不应承担识别这些专利的责任。本规范由江西省消防救援总队提出并归口。本规范主要起草单位：江西省消防救援总队、中国信息通信研究院。本规范参编单位：中国电信集团有限公司江西分公司、中国移动通信集团公司江西分公司、中国联合网络通信集团有限公司江西省分公司、南昌航空大学软件学院院。本规范起草人：朱飞勇、万灏、李论、张然、张振庭、陈淼、郭英男、陈琨、夏成华、万伟、刘伟琦、马红霞、吴君卓、王欢、朱玲红、孙晨、陈吕义、赵旭、余沣、王丹东、李童斐、周尔东、罗佳佳、傅强。DB36/T 12962020 1 城市消防物联网大数据应用平台接口规范 1 范围 本规范用于规定本省范围内省、市、县级城市消防物联网大数据应用平台之间，以及城市消防物联网大数据应用平台与社会单位、行业部门等其他消防管理服务平台之间的数据交换。本规范规定了数据交换过程的应用层通信协议。2 规范性引用文件 下列文件对于本规范的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本规范。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本规范。GB/T 4754-2017 国民经济分类 GB/T 12402-2000 经济类型分类与代码 GB 12955-2015 防火门 GB 14287-2014（所有部分）电气火灾监控系统 GB 16806-2006 消防联动控制系统 GB/T 22239-2019 信息安全技术网络安全等级保护基本要求 GB 25201-2010 建筑消防设施的维护管理 GB 25506-2010 消防控制室通用技术要求 GB 25972-2010 气体灭火系统及部件 GB/T 26875.3-2011 城市消防远程监控系统第 3 部分：报警传输网络通信协议 GB/T 26875.4-2011 城市消防远程监控系统第 4 部分：基础数据项 GB/T 30269.701-2014 信息技术传感器网络第 701 部分：传感器接口：信号接口 GB 50016-2014 建筑设计防火规范 GB 50084-2017 自动喷水灭火系统设计规范 GB 50116-2013 火灾自动报警系统设计规范 GB 50166-2019 火灾自动报警系统施工及验收规范 GB 50219-2014 水喷雾灭火系统设计规范 GB 50261-2017 自动喷水灭火系统施工及验收规范 GB 50370-2005 气体灭火系统设计规范 GA/T 396-2002 消防业务基础数据元与代码表 GA/T 1038.1-2012 消防公共服务平台技术规范 第 1 部分：总体架构及功能要求 GA/T 1038.2-2012 消防公共服务平台技术规范 第 2 部分：服务管理接口 GA/T 1038.3-2012 消防公共服务平台技术规范 第 3 部分：信息交换接口 GM/T 0054-2018 信息系统密码应用基本要求 3 术语和定义 DB36/T 12962020 2 下列术语和定义适用于本规范。3.1 城市消防物联网大数据应用平台 urban fire IoT big data application platform 由政府统一建设的用于消防监督管理的消防大数据应用平台，按照行政区划划分为省级、市级、县级等，服务于各级消防部门、行业部门、消防单位、维保、设备等消防产业企业。3.2 消防管理服务平台 management platform of FIoT 由社会单位建设的，负责信息感知设备的接入、管理、控制并提供相关基础应用服务的平台。3.3 平台管理 platform management 由政府统一建设的县、市级城市消防物联网大数据应用平台需要通过访问上级城市消防物联网大数据应用平台相关接口，完成平台的注册、变更等管理操作。社会单位建设的消防管理服务平台需要通过访问本级城市消防物联网大数据应用平台相关接口，完成平台的注册、变更等管理操作。3.4 数据字典下载 data dictionary download 县、市级城市消防物联网大数据应用平台和消防管理服务平台完成注册后需要从省级城市消防物联网大数据应用平台中下载数据字典，以保证各类数据统一编码。3.5 静态数据上传 static data upload 县、市级城市消防物联网大数据应用平台拥有的静态数据向上级城市消防物联网大数据应用平台进行数据传输，消防管理服务平台拥有的静态数据向本级城市消防物联网大数据应用平台进行数据传输。3.6 动态数据上传 dynamic data upload 县、市级城市消防物联网大数据应用平台拥有的动态数据向上级城市消防物联网大数据应用平台进行数据传输，消防管理服务平台拥有的动态数据向本级城市消防物联网大数据应用平台进行数据传输。3.7 操作数据上传 operation data upload 县、市级城市消防物联网大数据应用平台拥有的操作数据向上级城市消防物联网大数据应用平台进行数据传输，消防管理服务平台拥有的操作数据向本级城市消防物联网大数据应用平台进行数据传输。3.8 数据下发 data downlink DB36/T 12962020 3 省、市、县级城市消防物联网大数据应用平台根据业务需求下传各类消防数据。4 体系架构及协议层次 4.1 体系架构 省、市、县级政府消防物联网大数据应用平台间及本级城市消防物联网大数据应用平台与消防管理服务平台之间的逻辑架构如图 1 所示。图1 体系架构 4.2 协议层次与安全要求 4.2.1 省、市级城市消防物联网大数据应用平台与市、县级城市消防物联网大数据应用平台之间的协议关系如图 2 所示。图2 协议层次 4.2.2 消防管理服务平台与本级城市消防物联网大数据应用平台之间的协议关系如图 3 所示。DB36/T 12962020 4 图3 协议层次 4.2.3 城市消防物联网大数据应用平台应通过身份认证、传输加密、数据校验等方式确保数据传输的安全性，并应符合 GB/T 22239-2019、GM/T 0054-2018 等相关规定。5 应用协议 5.1 一般规定 5.1.1 身份验证 省、市、县级城市消防物联网大数据应用平台间，以及消防管理服务平台与本级城市消防物联网大数据应用平台间进行数据交互时，需采用统一要求的CA数字证书进行身份验证。5.1.2 应用接口协议 省、市、县级城市消防物联网大数据应用平台间，以及消防管理服务平台与本级城市消防物联网大数据应用平台间的应用接口协议包含平台管理、数据字典下载、静态数据上传、动态数据上传、操作数据上传、数据下发等协议，具体框架见图4。图4 应用接口协议 5.1.3 应用接口协议格式 应用接口协议格式见表1。DB36/T 12962020 5 表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 返回参数格式 参数名称 类型 说明 success bool 是否成功 errno 整数 错误码，0 为成功，其他为失败，见 5.1.6 节状态代码 errmsg 字符串 错误信息 其他返回参数/根据具体应用接口协议确定（处理成功后返回具体数据，否则为空）注：第6章通信流程所涉及的各业务接口，如未明确定义返回参数，则默认返回success、errno、errmsg参数。5.1.6 状态代码 编码规则：“0”代表成功，首位为“1”代表服务端错误，首位为“2”代表客户端错误，具体错误状态代码由“1”或“2”加三位排序号组成。具体状态代码及对应说明见表 4。表4 状态代码及说明 状态代码 状态说明 0 成功 1001 HTTP 解析错误 1002 HTTP 请求参数错误 1003 HTTP 请求 JSON 解析错误 1004 服务器处理失败 DB36/T 12962020 6 表 4 状态代码及说明（续）状态代码 状态说明 1005 请求频率超限 1006 数据更新（获取）失败 1007 数据已存在,不能重复添加 1008 数据不存在,不能修改 1009 数据解析失败 1010 预留 2001 appId 缺失 2002 timestamp 缺失 2003 sign 缺失 2004 appId 失效 2005 timestamp 失效 2006 sign 失效 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 静态数据上传方向 DB36/T 12962020 7 县、市级城市消防物联网大数据应用平台通过应用接口上传静态数据至上级城市消防物联网大数据应用平台；消防管理服务平台通过应用接口上传静态数据至本级城市消防物联网大数据应用平台。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。DB36/T 12962020 8 图5 平台注册及数据字典下载流程 6.1.2 静态数据上传流程 静态数据上传包含静态数据初始上传和静态数据变更上传，见图 6。开始CA认证不通过，返回通过失败，重新上传完成静态数据初始上传静态数据变更上传返回码验证返回码验证失败，重新上传上传成功上传成功 图6 静态数据上传流程 6.1.3 动态数据上传流程 动态数据上传包含动态数据初始上传和动态数据实时上传，见图 7。DB36/T 12962020 9 开始CA认证不通过，返回通过失败，重新上传完成动态数据初始上传动态数据实时上传返回码验证返回码验证失败，重新上传上传成功上传成功 图7 动态数据上传流程 6.1.4 操作数据上传流程 操作数据上传包含操作数据初始上传和操作数据实时上传，见图 8。开始CA认证不通过，返回通过失败，重新上传完成操作数据初始上传操作数据实时上传返回码验证返回码验证失败，重新上传上传成功上传成功 图8 操作数据上传流程 6.2 平台管理流程 6.2.1 平台注册及审批 首次接入时，县、市级城市消防物联网大数据应用平台应向上级城市消防物联网大数据应用平台发起注册请求；消防管理服务平台应向本级城市消防物联网大数据应用平台发起注册请求。收到注册请求的城市消防物联网大数据应用平台应对接入注册请求进行审批，审批通过后为接入的县、市级城市消防物联网大数据应用平台或消防管理服务平台分配唯一标识。DB36/T 12962020 10 6.2.2 平台变更 县、市级城市消防物联网大数据应用平台进行平台变更操作时，需要向上级城市消防物联网大数据应用平台进行报备审批；消防管理服务平台进行平台变更操作时，需要向本级城市消防物联网大数据应用平台进行报备审批。6.3 数据字典下载流程 6.3.1 数据字典配置信息 6.3.1.1 获取数据字典内容之前，县、市级城市消防物联网大数据应用平台和消防管理服务平台应首先获取数据字典的配置信息。6.3.1.2 接入的县、市级城市消防物联网大数据应用平台和消防管理服务平台根据获取的配置信息明确需要下载的数据字典内容。6.3.1.3 县、市级城市消防物联网大数据应用平台和消防管理服务平台首次接入后应根据省级城市消防物联网大数据应用平台返回的清单，依次调用相关的 API 接口获取数据字典信息。a)访问 API：/api/v1/dictConfig/list；b)请求参数：无；c)返回参数：见表 5；d)参数 dictConfig 说明：见表 6；e)调用示例：参见附录 B.1。表5 数据字典配置返回参数 参数名称 参数类型 说明 dictConfig list 需要下载的数据字典清单 表6 参数 dictConfig 说明 list 值 说明 monitorCenter 联网单位相关信息-监控中心 area 联网单位相关信息-行政区划 industryType 联网单位相关信息-行业类别 fireManagement 联网单位相关信息-消防部门 orgType 联网单位相关信息-单位类别 monitorLevel 联网单位相关信息-监管等级 monitorType 联网单位相关信息-监管类型 economicOwnership 联网单位相关信息-经济所有制 buildingType 建筑相关信息-建筑物类型 buildingNature 建筑相关信息-建筑使用性质 fireHazard 建筑相关信息-火灾危险性 refractoryGrade 建筑相关信息-耐火等级 buildingStructureType 建筑相关信息-结构类型 keyPartType 建筑相关信息-重点部位类型 manufacturer 设备类型-设备厂商 deviceType 设备类型-设备类型 DB36/T 12962020 11 表 6 参数 dictConfig 说明（续）list 值 说明 commMode 设备类型-通讯方式 tcqType 点位-探测器类型 mnlType 点位-模拟量类型 alarmCode 报警类型 pictureType 图纸类型 fireSystem 消防系统类型 6.3.1.4 县、市级城市消防物联网大数据应用平台及消防管理服务平台应定期向省级城市消防物联网大数据应用平台请求获取最新数据字典配置信息。6.3.2 联网单位相关信息 6.3.2.1 监控中心 监控中心信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取监控中心编码数据字典；b)通过 API 访问获取当前所属行政区划所有的监控中心名称与监控中心编码之间的对应关系；c)请求 API：/api/v1/monitorCenter/list；d)请求参数：见表 7（父级编码为地市或区县的编码，请求包含父级编码时，则返回请求的行政区划范围内监控中心名称与监控中心编码之间的对应关系，若请求不包含父级编码，则返回全省范围内监控中心名称与监控中心编码之间的对应关系）；e)返回参数：见表 8；f)调用示例：参见附录 B.2。表7 监控中心信息获取请求参数 参数名称 参数类型 是否必选 说明 parentCode string 否 父级编码（编码规则见附录 A.1）表8 监控中心信息获取返回参数 参数名称 参数类型 说明 centerCode string 监控中心编码（编码规则见附录 A.2）centerName string 监控中心名称 6.3.2.2 行政区划信息 行政区划信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取行政区划编码数据字典；b)通过 API 访问获取当前所属行政区划内所有的地市区县名称与地市区县编码之间的对应关系；c)请求 API：/api/v1/area/list；d)请求参数：见表 9（父级编码为地市或区县的编码，请求包含父级编码时，则返回请求的行政区划范围内地市区县名称与地市区县编码之间的对应关系，若请求不包含父级编码，则返回全省范围内全部地市区县名称与地市区县编码之间的对应关系）；DB36/T 12962020 12 e)返回参数：见表 10；f)调用示例：参见附录 B.3。表9 行政区划信息获取请求参数 参数名称 参数类型 是否必选 说明 parentCode string 否 父级编码（编码规则见附录 A.1）表10 行政区划信息获取返回参数 参数名称 参数类型 说明 areaCode string 行政区划编码（编码规则见附录 A.1）areaName string 行政区划名称 areaType string 行政区划类型（1：国家；2：省份、直辖市；3：地市；4：区县）6.3.2.3 行业类别 行业类别信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取行业类别编码数据字典；b)通过 API 访问获取当行业类别名称与行业类别编码之间的对应关系；c)请求 API：/api/v1/industryType/list；d)请求参数：无；e)返回参数：见表 11；f)调用示例：见附录 B.4。表11 行业类别信息获取返回参数 参数名称 参数类型 说明 industryCode string 行业类别编码（编码规则见附录 A.3）industryName string 行业类别名称 6.3.2.4 消防部门 消防部门信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取消防部门编码数据字典；b)通过 API 访问获取当前所属行政区划所有的消防部门名称与消防部门编码之间的对应关系；c)请求 API：/api/v1/fireManagement/list；d)请求参数：见表 12（父级编码为地市或区县的编码，请求包含父级编码时，则返回请求的行政区划范围内消防部门名称与消防部门编码之间的对应关系，若请求不包含父级编码，则返回全省范围内消防部门名称与消防部门编码之间的对应关系）；e)返回参数：见表 13；f)调用示例：参见附录 B.5。表12 消防部门信息获取请求参数 参数名称 参数类型 是否必选 说明 parentCode string 否 父级编码（编码规则见附录 A.3）DB36/T 12962020 13 表13 消防部门信息获取返回参数 参数名称 参数类型 说明 fireManagementCode string 消防部门编码（编码规则见附录 A.4）fireManagementName string 消防部门名称 6.3.2.5 单位类别 单位类别信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取单位类别编码数据字典；b)通过 API 访问获取单位类别名称与单位类别编码之间的对应关系；c)请求 API：/api/v1/orgType/list；d)请求参数：无；e)返回参数：见表 14；f)调用示例:参见附录 B.6。表14 单位类别信息获取返回参数 参数名称 参数类型 说明 orgTypeCode string 单位类别编码（编码规则见附录 A.5）orgTypeName string 单位类别名称 6.3.2.6 监管等级 监管等级信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取监管等级编码数据字典；b)通过 API 访问获取监管等级名称与监管等级编码之间的对应关系；c)请求 API：/api/v1/monitorLevel/list；d)请求参数：无；e)返回参数：见表 15；f)调用示例：参加附录 B.7。表15 监管等级信息获取返回参数 参数名称 参数类型 说明 monitorLevelCode string 监管等级编码（编码规则见附录 A.6）monitorLevelName string 监管等级名称 6.3.2.7 监管类别 监管类别信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取监管类别编码数据字典；b)通过 API 访问获取监管类别名称与监管类别编码之间的对应关系；c)请求 API：/api/v1/monitorType/list；d)请求参数：无；e)返回参数：见表 16；f)调用示例：参见附录 B.8。DB36/T 12962020 14 表16 监管类别信息获取返回参数 参数名称 参数类型 说明 monitorTypeCode string 监管类别编码（编码规则见附录 A.7）monitorTypeName string 监管类别名称 6.3.2.8 经济所有制 经济所有制信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取经济所有制编码数据字典；b)通过 API 访问获取经济所有制名称与经济所有制编码之间的对应关系；c)请求 API：/api/v1/economicOwnership/list；d)请求参数：无；e)返回参数：见表 17；f)调用示例：参见附录 B.9。表17 经济所有制信息获取返回参数 参数名称 参数类型 说明 economicOwnershipCode string 经济所有制编码（编码规则见附录 A.8）economicOwnershipName string 经济所有制名称 6.3.3 建筑相关信息 6.3.3.1 建筑物类型 建筑物类型信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取建筑物类型编码数据字典；b)通过 API 访问获取建筑物类型名称与建筑物类型编码之间的对应关系；c)请求 API：/api/v1/buildingType/list；d)请求参数：无；e)返回参数：见表 18；f)调用示例：参见附录 B.10。表18 建筑物类型信息获取返回参数 参数名称 参数类型 说明 buildingTypeCode string 建筑物类型编码（编码规则见附录 A.9）buildingTypeName string 建筑物类型名称 6.3.3.2 建筑使用性质 建筑使用性质信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取建筑使用性质编码数据字典；b)通过 API 访问获取建筑使用性质名称与建筑使用性质编码之间的对应关系；c)请求 API：/api/v1/buildingNature/list；d)请求参数：无；e)返回参数：见表 19；f)调用示例:参见附录 B.11。DB36/T 12962020 15 表19 建筑使用性质信息获取返回参数 参数名称 参数类型 说明 buildingNatureCode string 建筑使用性质编码（编码规则见附录 A.10）buildingNatureName string 建筑使用性质名称 6.3.3.3 火灾危险性 火灾危险性信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取火灾危险性编码数据字典；b)通过 API 访问获取火灾危险性名称与火灾危险性编码之间的对应关系；c)请求 API：/api/v1/fireHazard/list；d)请求参数：无；e)返回参数：见表 20；f)调用示例：参见附录 B.12。表20 火灾危险性信息获取返回参数 参数名称 参数类型 说明 fireHazardCode string 火灾危险性编码（编码规则见附录 A.11）fireHazardName string 火灾危险性名称 6.3.3.4 耐火等级 耐火等级信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取耐火等级编码数据字典；b)通过 API 访问获取耐火等级名称与耐火等级编码之间的对应关系；c)请求 API：/api/v1/refractoryGrade/list；d)请求参数：无；e)返回参数：见表 21；f)调用示例：参见附录 B.13。表21 耐火等级信息获取返回参数 参数名称 参数类型 说明 refractoryGradeCode string 耐火等级编码（编码规则见附录 A.12）refractoryGradeName string 耐火等级名称 6.3.3.5 结构类型 结构类型信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取结构类型编码数据字典；b)通过 API 访问获取结构类型名称与结构类型编码之间的对应关系；c)请求 API：/api/v1/buildingStructType/list；d)请求参数：无；e)返回参数：见表 22；f)调用示例：参见附录 B.14。DB36/T 12962020 16 表22 结构类型信息获取返回参数 参数名称 参数类型 说明 buildingStructTypeCode string 结构类型编码（编码规则见附录 A.13）buildingStructTypeName string 结构类型名称 6.3.3.6 重点部位类型 重点部位类型信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取重点部位类型编码数据字典；b)通过 API 访问获取重点部位类型名称与重点部位类型编码之间的对应关系；c)请求 API：/api/v1/keyPartType/list；d)请求参数：无；e)返回参数：见表 23；f)调用示例:参见附录 B.15。表23 重点部位类型信息获取返回参数 参数名称 参数类型 说明 keyPartTypeCode string 重点部位类型编码（编码规则见附录 A.14）keyPartTypeName string 重点部位类型名称 6.3.4 设备类型 6.3.4.1 设备厂商 设备厂商信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取设备厂商编码数据字典；b)通过 API 访问获取设备厂商名称与设备厂商编码之间的对应关系；c)请求 API：/api/v1/manufacturer/list；d)请求参数：无；e)返回参数：见表 24；f)调用示例：参见附录 B.16。表24 设备厂商信息获取返回参数 参数名称 参数类型 说明 manufacturerCode string 厂商编码（编码规则见附录 A.15）manufacturerName string 厂商名称 6.3.4.2 设备型号 设备型号信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取设备型号数据字典；b)通过 API 访问获取设备型号与设备类型编码之间的对应关系；c)请求 API：/api/v1/deviceType/list；d)请求参数：无；e)返回参数：见表 25；f)调用示例：参见附录 B.17。DB36/T 12962020 17 表25 设备型号信息获取返回参数 参数名称 参数类型 说明 deviceType string 设备型号 manufacturerCode string 厂商编码（编码规则见附录 A.15）deviceCode string 设备类型编码（编码规则见附录 A.16）deviceCodeName string 设备类型名称 6.3.4.3 设备通讯方式 设备通讯方式信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取设备通讯方式数据字典；b)通过 API 访问获取通讯方式名称与通讯方式编码之间的对应关系；c)请求 API：/api/v1/commMode/list；d)请求参数：无；e)返回参数：见表 26；f)调用示例：参见附录 B.18。表26 设备通讯方式信息获取返回参数 参数名称 参数类型 说明 commModeCode string 通讯方式编码（编码规则见附录 A.17）commModeName string 通讯方式名称 6.3.5 点位相关信息 6.3.5.1 探测器类型 探测器类型信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取探测器类型数据字典；b)通过 API 访问获取探测器类型名称与探测器类型编码之间的对应关系；c)请求 API：/api/v1/tcqType/list；d)请求参数：无；e)返回参数：见表 27；f)调用示例：参见附录 B.19。表27 探测器类型信息获取返回参数 参数名称 参数类型 说明 detectorTypeCode string 探测器类型编码（编码规则见附录 A.18）detectorTypeName string 探测器类型名称 6.3.5.2 模拟量类型 模拟量类型信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取模拟量类型数据字典；b)通过 API 访问获取模拟量类型名称与模拟量类型编码之间的对应关系；c)请求 API：/api/v1/mnlType/list；d)请求参数：无；DB36/T 12962020 18 e)返回参数：见表 28；f)调用示例：参见附录 B.20。表28 模拟量类型信息获取返回参数 参数名称 参数类型 说明 mnltypeCode string 模拟量类型编码（编码规则见附录 A.19）mnltypeName string 模拟量类型名称 unit string 单位 minMetering string 最小值 6.3.6 报警类型 报警类型信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取报警类型数据字典；b)通过 API 访问获取报警类型与报警类型编码之间的对应关系；c)请求 API：/api/v1/alarmCode/list；d)请求参数：无；e)返回参数：见表 29；f)调用示例：参见附录 B.21。表29 报警类型信息获取返回参数 参数名称 参数类型 说明 alarmCode string 报警类型编码（编码规则见附录 A.20）alarmType string 报警类型 6.3.7 图纸类型 图纸类型信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取图纸类型数据字典；b)通过 API 访问获取图纸类型名称与图纸类型编码之间的对应关系；c)请求 API：/api/v1/pictureType/list；d)请求参数：无；e)返回参数：见表 30；f)调用示例：参见附录 B.22。表30 图纸类型信息获取返回参数 参数名称 参数类型 说明 pictureTypeCode string 图纸类型编码（编码规则见附录 A.23）pictureTypeName string 图纸类型名称 6.3.8 消防系统 消防系统信息获取方式如下：a)根据 6.3.1.2 中返回的清单获取消防系统数据字典；b)通过 API 访问获取消防系统类型名称与消防系统类型编码之间的对应关系；DB36/T 12962020 19 c)请求 API：/api/v1/fireSystem/list；d)请求参数：无；e)返回参数：见表 31；f)调用示例：参见附录 B.23。表31 消防系统信息获取返回参数 参数名称 参数类型 说明 fireSystemCode string 消防系统类型编码（编码规则见附录 A.21）fireSystemName string 消防系统类型名称 6.4 静态数据上传流程 6.4.1 静态数据上传要求 县、市级城市消防物联网大数据应用平台所接入的联网单位、建筑、重点部位、消控室等静态信息，需上传至上级城市消防物联网大数据应用平台；消防管理服务平台所接入的联网单位、建筑、重点部位、消控室等静态信息，需上传至本级城市消防物联网大数据应用平台。6.4.2 联网单位信息上传 6.4.2.1 联网单位新增 联网单位新增流程如下：a)县、市级城市消防物联网大数据应用平台接入新的联网单位信息后，将信息上传至上级城市消防物联网大数据应用平台；消防管理服务平台接入新的联网单位信息后，将信息上传至本级城市消防物联网大数据应用平台；b)请求 API：/api/v1/unit/add；c)请求参数：见表 32；d)返回参数：见表 33；e)调用示例：参见附录 B.24。表32 联网单位新增请求参数 参数名称 参数类型 是否必选 说明 companyName string 是 单位名称 areaCode string 是 归属行政区划（编码规则见附录 A.1）industryType string 是 所属行业类别（编码规则见附录 A.3）lng double 是 地理坐标经度（BD09 坐标系）lat double 是 地理坐标维度（BD09 坐标系）orgLicense string 是 统一社会信用代码 orgType string 是 单位类别（编码规则见附录 A.5）address string 是 单位地址 postalCode string 是 邮政编码 workNum Integer 否 职工总人数 orgLicenseTime date 否 成立时间(yyyy-MM-dd)economicOwnership string 否 经济所有制（编码规则见附录 A.8）fixedAssets double 否 固定资产 unitArea double 否 单位占地面积 DB36/T 129620