(高清版)DB36_T 1296-2021城市消防物联网大数据应用平台接口规范.pdf
《(高清版)DB36_T 1296-2021城市消防物联网大数据应用平台接口规范.pdf》由会员分享,可在线阅读,更多相关《(高清版)DB36_T 1296-2021城市消防物联网大数据应用平台接口规范.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(规范性附录)编码信息.43 附录 B(资料
2、性附录)调用示例.60 本规程用词说明.122 DB36/T 12962020 II 前 言 本规范按照GB/T 1.1-2020的规定起草。本规范的某些内容可能涉及专利,本文件发布机构不应承担识别这些专利的责任。本规范由江西省消防救援总队提出并归口。本规范主要起草单位:江西省消防救援总队、中国信息通信研究院。本规范参编单位:中国电信集团有限公司江西分公司、中国移动通信集团公司江西分公司、中国联合网络通信集团有限公司江西省分公司、南昌航空大学软件学院院。本规范起草人:朱飞勇、万灏、李论、张然、张振庭、陈淼、郭英男、陈琨、夏成华、万伟、刘伟琦、马红霞、吴君卓、王欢、朱玲红、孙晨、陈吕义、赵旭、余
3、沣、王丹东、李童斐、周尔东、罗佳佳、傅强。DB36/T 12962020 1 城市消防物联网大数据应用平台接口规范 1 范围 本规范用于规定本省范围内省、市、县级城市消防物联网大数据应用平台之间,以及城市消防物联网大数据应用平台与社会单位、行业部门等其他消防管理服务平台之间的数据交换。本规范规定了数据交换过程的应用层通信协议。2 规范性引用文件 下列文件对于本规范的应用是必不可少的。凡是注日期的引用文件,仅所注日期的版本适用于本规范。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本规范。GB/T 4754-2017 国民经济分类 GB/T 12402-2000 经济类型分类与代码
4、 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 信息技术传感器网络第 7
5、01 部分:传感器接口:信号接口 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 消防公
6、共服务平台技术规范 第 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 消防管理服务平台 manageme
7、nt platform of FIoT 由社会单位建设的,负责信息感知设备的接入、管理、控制并提供相关基础应用服务的平台。3.3 平台管理 platform management 由政府统一建设的县、市级城市消防物联网大数据应用平台需要通过访问上级城市消防物联网大数据应用平台相关接口,完成平台的注册、变更等管理操作。社会单位建设的消防管理服务平台需要通过访问本级城市消防物联网大数据应用平台相关接口,完成平台的注册、变更等管理操作。3.4 数据字典下载 data dictionary download 县、市级城市消防物联网大数据应用平台和消防管理服务平台完成注册后需要从省级城市消防物联网大数据
8、应用平台中下载数据字典,以保证各类数据统一编码。3.5 静态数据上传 static data upload 县、市级城市消防物联网大数据应用平台拥有的静态数据向上级城市消防物联网大数据应用平台进行数据传输,消防管理服务平台拥有的静态数据向本级城市消防物联网大数据应用平台进行数据传输。3.6 动态数据上传 dynamic data upload 县、市级城市消防物联网大数据应用平台拥有的动态数据向上级城市消防物联网大数据应用平台进行数据传输,消防管理服务平台拥有的动态数据向本级城市消防物联网大数据应用平台进行数据传输。3.7 操作数据上传 operation data upload 县、市级城市
9、消防物联网大数据应用平台拥有的操作数据向上级城市消防物联网大数据应用平台进行数据传输,消防管理服务平台拥有的操作数据向本级城市消防物联网大数据应用平台进行数据传输。3.8 数据下发 data downlink DB36/T 12962020 3 省、市、县级城市消防物联网大数据应用平台根据业务需求下传各类消防数据。4 体系架构及协议层次 4.1 体系架构 省、市、县级政府消防物联网大数据应用平台间及本级城市消防物联网大数据应用平台与消防管理服务平台之间的逻辑架构如图 1 所示。图1 体系架构 4.2 协议层次与安全要求 4.2.1 省、市级城市消防物联网大数据应用平台与市、县级城市消防物联网大
10、数据应用平台之间的协议关系如图 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数字证书进行身份验证。
11、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,支持版本号递增,并向前
12、兼容。interfaceName表示接口名称,详细见各业务接口定义。5.1.4 请求参数格式 请求参数格式见表2。表2 请求参数格式 参数名称 类型 说明 appId 字符串 首次注册时,申请接入的平台经上级平台审核通过后,由上级平台统一返回appId timestamp 整数 Unix时间戳,请求发起时间,如果和系统时间相差超过10分钟则会返回失败 sign 字符串 app凭证 其他请求参数/根据具体接口协议确定 5.1.5 返回参数格式 返回参数格式见表3。表3 返回参数格式 参数名称 类型 说明 success bool 是否成功 errno 整数 错误码,0 为成功,其他为失败,见 5
13、.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
14、 服务器处理失败 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 注册请求 首次接入时,县、市级城市消防物联网大数据应用平台应向上级城市消防物联网
15、大数据应用平台发起注册请求;消防管理服务平台应向本级城市消防物联网大数据应用平台发起注册请求。5.2.2 标识分配 收到注册请求的城市消防物联网大数据应用平台应对接入注册请求进行审批,审批通过后为接入的县、市级城市消防物联网大数据应用平台或消防管理服务平台分配唯一标识。5.2.3 平台变更 县、市级城市消防物联网大数据应用平台进行平台变更操作时,需要向上级城市消防物联网大数据应用平台进行报备审批;消防管理服务平台进行平台变更操作时,需要向本级城市消防物联网大数据应用平台进行报备审批。5.3 数据字典下载规定 5.3.1 数据字典一致性 县、市级城市消防物联网大数据应用平台及消防管理服务平台应使
16、用与省级城市消防物联网大数据应用平台相同的数据字典。5.3.2 数据字典获取方式 县、市级城市消防物联网大数据应用平台及消防管理服务平台应从省级城市消防物联网大数据应用平台获取数据字典。5.3.3 数据字典下载要求 县、市级城市消防物联网大数据应用平台及消防管理服务平台的数据字典下载应符合本规范 6.3节相关要求。5.4 静态数据上传规定 5.4.1 静态数据上传方向 DB36/T 12962020 7 县、市级城市消防物联网大数据应用平台通过应用接口上传静态数据至上级城市消防物联网大数据应用平台;消防管理服务平台通过应用接口上传静态数据至本级城市消防物联网大数据应用平台。5.4.2 静态数据
17、上传要求 县、市级城市消防物联网大数据应用平台向上级城市消防物联网大数据应用平台,以及消防管理服务平台向本级城市消防物联网大数据应用平台传递的静态数据应符合本规范 6.4 节相关要求。5.5 动态数据上传规定 5.5.1 动态数据上传方向 县、市级城市消防物联网大数据应用平台通过应用接口上传动态数据至上级城市消防物联网大数据应用平台;消防管理服务平台通过应用接口上传动态数据至本级城市消防物联网大数据应用平台。5.5.2 动态数据上传要求 县、市级城市消防物联网大数据应用平台向上级城市消防物联网大数据应用平台,以及消防管理服务平台向本级城市消防物联网大数据应用平台传递的动态数据应符合本规范 6.
18、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认证不通过,返回通过失败,重新上传完成静态数据初始上传静态数据变更上传返回码验证返回码验证失败,重新上传上传成功上传成功 图6 静态数据上传流程 6.
20、1.3 动态数据上传流程 动态数据上传包含动态数据初始上传和动态数据实时上传,见图 7。DB36/T 12962020 9 开始CA认证不通过,返回通过失败,重新上传完成动态数据初始上传动态数据实时上传返回码验证返回码验证失败,重新上传上传成功上传成功 图7 动态数据上传流程 6.1.4 操作数据上传流程 操作数据上传包含操作数据初始上传和操作数据实时上传,见图 8。开始CA认证不通过,返回通过失败,重新上传完成操作数据初始上传操作数据实时上传返回码验证返回码验证失败,重新上传上传成功上传成功 图8 操作数据上传流程 6.2 平台管理流程 6.2.1 平台注册及审批 首次接入时,县、市级城市消
21、防物联网大数据应用平台应向上级城市消防物联网大数据应用平台发起注册请求;消防管理服务平台应向本级城市消防物联网大数据应用平台发起注册请求。收到注册请求的城市消防物联网大数据应用平台应对接入注册请求进行审批,审批通过后为接入的县、市级城市消防物联网大数据应用平台或消防管理服务平台分配唯一标识。DB36/T 12962020 10 6.2.2 平台变更 县、市级城市消防物联网大数据应用平台进行平台变更操作时,需要向上级城市消防物联网大数据应用平台进行报备审批;消防管理服务平台进行平台变更操作时,需要向本级城市消防物联网大数据应用平台进行报备审批。6.3 数据字典下载流程 6.3.1 数据字典配置信
22、息 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)调用示例:参见附
23、录 B.1。表5 数据字典配置返回参数 参数名称 参数类型 说明 dictConfig list 需要下载的数据字典清单 表6 参数 dictConfig 说明 list 值 说明 monitorCenter 联网单位相关信息-监控中心 area 联网单位相关信息-行政区划 industryType 联网单位相关信息-行业类别 fireManagement 联网单位相关信息-消防部门 orgType 联网单位相关信息-单位类别 monitorLevel 联网单位相关信息-监管等级 monitorType 联网单位相关信息-监管类型 economicOwnership 联网单位相关信息-经济所有
24、制 buildingType 建筑相关信息-建筑物类型 buildingNature 建筑相关信息-建筑使用性质 fireHazard 建筑相关信息-火灾危险性 refractoryGrade 建筑相关信息-耐火等级 buildingStructureType 建筑相关信息-结构类型 keyPartType 建筑相关信息-重点部位类型 manufacturer 设备类型-设备厂商 deviceType 设备类型-设备类型 DB36/T 12962020 11 表 6 参数 dictConfig 说明(续)list 值 说明 commMode 设备类型-通讯方式 tcqType 点位-探测器类型
25、 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)请求参数:见
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 高清版DB36_T 1296-2021城市消防物联网大数据应用平台接口规范 高清版 DB36_T 1296 2021 城市 消防 联网 数据 应用 平台 接口 规范
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【Fis****915】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【Fis****915】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。