DB36 T 1296-2020 城市消防物联网大数据应用平台接口规范.pdf
《DB36 T 1296-2020 城市消防物联网大数据应用平台接口规范.pdf》由会员分享,可在线阅读,更多相关《DB36 T 1296-2020 城市消防物联网大数据应用平台接口规范.pdf(126页珍藏版)》请在麦多课文档分享上搜索。
1、 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(规范性附录) 编码信息
2、.43 附录B(资料性附录) 调用示例.60 本规程用词说明.122 DB36/T 12962020 II 前 言 本规范按照GB/T 1.1-2020的规定起草。 本规范的某些内容可能涉及专利,本文件发布机构不应承担识别这些专利的责任。 本规范由江西省消防救援总队提出并归口。 本规范主要起草单位:江西省消防救援总队、中国信息通信研究院。 本规范参编单位:中国电信集团有限公司江西分公司、中国移动通信集团公司江西分公司、中国联 合网络通信集团有限公司江西省分公司、南昌航空大学软件学院院。 本规范起草人:朱飞勇、万灏、李论、张然、张振庭、陈淼、郭英男、陈琨、夏成华、万伟、刘伟 琦、马红霞、吴君卓、
3、王欢、朱玲红、孙晨、陈吕义、赵旭、余沣、王丹东、李童斐、周尔东、罗佳佳、 傅强。 DB36/T 12962020 1 城市消防物联网大数据应用平台接口规范 1 范围 本规范用于规定本省范围内省、市、县级城市消防物联网大数据应用平台之间,以及城市消防物联 网大数据应用平台与社会单位、行业部门等其他消防管理服务平台之间的数据交换。 本规范规定了数据交换过程的应用层通信协议。 2 规范性引用文件 下列文件对于本规范的应用是必不可少的。凡是注日期的引用文件,仅所注日期的版本适用于本规 范。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本规范。 GB/T 4754-2017 国民经济分类
4、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 3
5、0269.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 部分:总体架构
6、及功能要求 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 由政府统一建设的用于消防监督管理的消防大数据应用平台,按照行政区划划分为省级、市级、县 级等,服务于各级消防部门、行业部门、消防单位、维保、设备等
7、消防产业企业。 3.2 消防管理服务平台 management platform of FIoT 由社会单位建设的,负责信息感知设备的接入、管理、控制并提供相关基础应用服务的平台。 3.3 平台管理platform management 由政府统一建设的县、市级城市消防物联网大数据应用平台需要通过访问上级城市消防物联网大数 据应用平台相关接口,完成平台的注册、变更等管理操作。社会单位建设的消防管理服务平台需要通过 访问本级城市消防物联网大数据应用平台相关接口,完成平台的注册、变更等管理操作。 3.4 数据字典下载 data dictionary download 县、市级城市消防物联网大数据应
8、用平台和消防管理服务平台完成注册后需要从省级城市消防物联 网大数据应用平台中下载数据字典,以保证各类数据统一编码。 3.5 静态数据上传 static data upload 县、市级城市消防物联网大数据应用平台拥有的静态数据向上级城市消防物联网大数据应用平台进 行数据传输,消防管理服务平台拥有的静态数据向本级城市消防物联网大数据应用平台进行数据传输。 3.6 动态数据上传 dynamic data upload 县、市级城市消防物联网大数据应用平台拥有的动态数据向上级城市消防物联网大数据应用平台进 行数据传输,消防管理服务平台拥有的动态数据向本级城市消防物联网大数据应用平台进行数据传输。 3
9、.7 操作数据上传 operation data upload 县、市级城市消防物联网大数据应用平台拥有的操作数据向上级城市消防物联网大数据应用平台进 行数据传输,消防管理服务平台拥有的操作数据向本级城市消防物联网大数据应用平台进行数据传输。 3.8 数据下发 data downlink DB36/T 12962020 3 省、市、县级城市消防物联网大数据应用平台根据业务需求下传各类消防数据。 4 体系架构及协议层次 4.1 体系架构 省、市、县级政府消防物联网大数据应用平台间及本级城市消防物联网大数据应用平台与消防管理 服务平台之间的逻辑架构如图1所示。 图1 体系架构 4.2 协议层次与安
10、全要求 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 身份验证 省、市、县级城市消防物联网大数据应用平台间,以及消防管理服务平台与本级城市消防
11、物联网大 数据应用平台间进行数据交互时,需采用统一要求的CA数字证书进行身份验证。 5.1.2 应用接口协议 省、市、县级城市消防物联网大数据应用平台间,以及消防管理服务平台与本级城市消防物联网大 数据应用平台间的应用接口协议包含平台管理、数据字典下载、静态数据上传、动态数据上传、操作数 据上传、数据下发等协议,具体框架见图4。 图4 应用接口协议 5.1.3 应用接口协议格式 应用接口协议格式见表1。 DB36/T 12962020 5 表1 应用接口协议格式 协议 POST 编码格式 UTF-8 URL示例 https:/IP地址:端口号/api/版本号(version)/接口名称(int
12、erfaceName) 注:version表示版本号,初始版本号为v1,支持版本号递增,并向前兼容。interfaceName表示接口名称,详细见 各业务接口定义。 5.1.4 请求参数格式 请求参数格式见表2。 表2 请求参数格式 参数名称 类型 说明 appId 字符串 首次注册时,申请接入的平台经上级平台审核通过后,由上级平台统一返 回appId timestamp 整数 Unix时间戳,请求发起时间,如果和系统时间相差超过10分钟则会返回失 败 sign 字符串 app凭证 其他请求参数 / 根据具体接口协议确定 5.1.5 返回参数格式 返回参数格式见表3。 表3 返回参数格式 参数
13、名称 类型 说明 success bool 是否成功 errno 整数 错误码,0为成功,其他为失败,见5.1.6节状态代码 errmsg 字符串 错误信息 其他返回参数 / 根据具体应用接口协议确定(处理成功后返回具体数据,否则为空) 注:第6章通信流程所涉及的各业务接口,如未明确定义返回参数,则默认返回success、errno、errmsg参数。 5.1.6 状态代码 编码规则:“0”代表成功,首位为“1”代表服务端错误,首位为“2”代表客户端错误,具体错 误状态代码由“1”或“2”加三位排序号组成。具体状态代码及对应说明见表4。 表4 状态代码及说明 状态代码 状态说明 0 成功 10
14、01 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 平台管理规定
15、5.2.1 注册请求 首次接入时,县、市级城市消防物联网大数据应用平台应向上级城市消防物联网大数据应用平台发 起注册请求;消防管理服务平台应向本级城市消防物联网大数据应用平台发起注册请求。 5.2.2 标识分配 收到注册请求的城市消防物联网大数据应用平台应对接入注册请求进行审批,审批通过后为接入的 县、市级城市消防物联网大数据应用平台或消防管理服务平台分配唯一标识。 5.2.3 平台变更 县、市级城市消防物联网大数据应用平台进行平台变更操作时,需要向上级城市消防物联网大数据 应用平台进行报备审批;消防管理服务平台进行平台变更操作时,需要向本级城市消防物联网大数据应 用平台进行报备审批。 5.3
16、 数据字典下载规定 5.3.1 数据字典一致性 县、市级城市消防物联网大数据应用平台及消防管理服务平台应使用与省级城市消防物联网大数据 应用平台相同的数据字典。 5.3.2 数据字典获取方式 县、市级城市消防物联网大数据应用平台及消防管理服务平台应从省级城市消防物联网大数据应用 平台获取数据字典。 5.3.3 数据字典下载要求 县、市级城市消防物联网大数据应用平台及消防管理服务平台的数据字典下载应符合本规范6.3 节相关要求。 5.4 静态数据上传规定 5.4.1 静态数据上传方向 DB36/T 12962020 7 县、市级城市消防物联网大数据应用平台通过应用接口上传静态数据至上级城市消防物
17、联网大数据 应用平台;消防管理服务平台通过应用接口上传静态数据至本级城市消防物联网大数据应用平台。 5.4.2 静态数据上传要求 县、市级城市消防物联网大数据应用平台向上级城市消防物联网大数据应用平台,以及消防管理服 务平台向本级城市消防物联网大数据应用平台传递的静态数据应符合本规范6.4节相关要求。 5.5 动态数据上传规定 5.5.1 动态数据上传方向 县、市级城市消防物联网大数据应用平台通过应用接口上传动态数据至上级城市消防物联网大数据 应用平台;消防管理服务平台通过应用接口上传动态数据至本级城市消防物联网大数据应用平台。 5.5.2 动态数据上传要求 县、市级城市消防物联网大数据应用平
18、台向上级城市消防物联网大数据应用平台,以及消防管理服 务平台向本级城市消防物联网大数据应用平台传递的动态数据应符合本规范6.5节相关要求。 5.6 操作数据上传规定 5.6.1 操作数据上传方向 县、市级城市消防物联网大数据应用平台通过应用接口上传操作数据至上级城市消防物联网大数据 应用平台;消防管理服务平台通过应用接口上传操作数据至本级城市消防物联网大数据应用平台。 5.6.2 操作数据上传要求 县、市级城市消防物联网大数据应用平台向上级城市消防物联网大数据应用平台,以及消防管理服 务平台向本级城市消防物联网大数据应用平台传递的操作数据应符合本规范6.6节相关要求。 5.7 数据下发规定 上
19、级城市消防物联网大数据应用平台向县、市级城市消防物联网大数据应用平台下发数据,或本级 城市消防物联网大数据应用平台向消防管理服务平台下发数据应符合本规范第6章相关要求。 6 通信流程 6.1 流程概述 6.1.1 平台注册及数据字典下载流程 首先由县、市级城市消防物联网大数据应用平台及消防管理服务平台向对应的城市消防物联网大数 据应用平台注册,完成后向省级城市消防物联网大数据应用平台请求数据字典下载,见图5。 DB36/T 12962020 8 图5 平台注册及数据字典下载流程 6.1.2 静态数据上传流程 静态数据上传包含静态数据初始上传和静态数据变更上传,见图6。 开始 CA认证 不通过,
20、返回通过 失败,重新上传完成静态数据初始上传 静态数据变更上传返回码验证 返回码验证失败,重新上传 上传成功 上传成功 图6 静态数据上传流程 6.1.3 动态数据上传流程 动态数据上传包含动态数据初始上传和动态数据实时上传,见图7。 DB36/T 12962020 9 开始 CA认证 不通过,返回通过 失败,重新上传 完成 动态数据初始上传 动态数据实时上传返回码验证 返回码验证失败,重新上传 上传成功 上传成功 图7 动态数据上传流程 6.1.4 操作数据上传流程 操作数据上传包含操作数据初始上传和操作数据实时上传,见图8。 开始 CA认证 不通过,返回通过 失败,重新上传完成操作数据初始
21、上传 操作数据实时上传返回码验证 返回码验证失败,重新上传 上传成功 上传成功 图8 操作数据上传流程 6.2 平台管理流程 6.2.1 平台注册及审批 首次接入时,县、市级城市消防物联网大数据应用平台应向上级城市消防物联网大数据应用平台发 起注册请求;消防管理服务平台应向本级城市消防物联网大数据应用平台发起注册请求。收到注册请求 的城市消防物联网大数据应用平台应对接入注册请求进行审批,审批通过后为接入的县、市级城市消防 物联网大数据应用平台或消防管理服务平台分配唯一标识。 DB36/T 12962020 10 6.2.2 平台变更 县、市级城市消防物联网大数据应用平台进行平台变更操作时,需要
22、向上级城市消防物联网大数据 应用平台进行报备审批;消防管理服务平台进行平台变更操作时,需要向本级城市消防物联网大数据应 用平台进行报备审批。 6.3 数据字典下载流程 6.3.1 数据字典配置信息 6.3.1.1 获取数据字典内容之前,县、市级城市消防物联网大数据应用平台和消防管理服务平台 应首先获取数据字典的配置信息。 6.3.1.2 接入的县、市级城市消防物联网大数据应用平台和消防管理服务平台根据获取的配置信 息明确需要下载的数据字典内容。 6.3.1.3 县、市级城市消防物联网大数据应用平台和消防管理服务平台首次接入后应根据省级城 市消防物联网大数据应用平台返回的清单,依次调用相关的AP
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB36 1296-2020 城市消防物联网大数据应用平台接口规范 1296 2020 城市 消防 联网 数据 应用 平台 接口 规范
