DB33∕T 2477-2022 消防物联网系统对接技术规范(浙江省).pdf
《DB33∕T 2477-2022 消防物联网系统对接技术规范(浙江省).pdf》由会员分享,可在线阅读,更多相关《DB33∕T 2477-2022 消防物联网系统对接技术规范(浙江省).pdf(81页珍藏版)》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、 ICS 35.240.01 CCS L 65 33 浙江省地方标准 DB33/T 24772022 消防物联网系统对接技术规范 Technical Specification for Fire Internet of Things System Integration BDB33/T 24772022 I 目次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.2 5 系统对接模型.2 组成部分.2 5.1 对接功能.3 5.2 6 基本要求.3 功能要求.3 6.1 安全要求.4 6.2 数据传输时间要求.4 6.3 接口要求.5 6.4 7 接口实现.5
2、数据查询.5 7.1 数据推送.11 7.2 消防视频调用.23 7.3 附录 A(规范性)平台联网消息交互流程.26 附录 B(规范性)数据元描述.30 附录 C(资料性)REST 架构协议模型.58 附录 D(资料性)接口消息规范.62 附录 E(规范性)运营服务机构唯一编码规则.64 附录 F(规范性)数据字典.65 参考文献.77 DB33/T 24772022 II 前言 本标准按照GB/T 1.12020标准化工作导则 第1部分:标准化文件的结构和起草规则的规定起草。请注意本标准的某些内容可能涉及专利。本标准的发布机构不承担识别专利的责任。本标准由浙江省消防救援总队提出、归口并组织
3、实施。本标准起草单位:中国电信股份有限公司浙江分公司、杭州海康消防科技有限公司、浙江大华技术股份有限公司、华为技术有限公司、阿里云计算有限公司、中国移动通信集团有限公司浙江分公司、杭州竟火科技有限公司。本标准主要起草人:严晓龙、金辉、黄亚东、刘涛、吕锋、李楠、庞霄波、丁诗懿、姚弋、王坚平、张旭阳、陈卫平、蔡旭东、周雁、顾孟钧、李勇、郑金荣、吴天桂、王正庭、袁惟道、杨永林、徐志春、刘新明、陈伟、莫少泽、程智慧。DB33/T 24772022 1 消防物联网系统对接技术规范 1 范围 本标准规定了消防物联网系统数据对接的系统对接模型、基本要求和接口实现。本标准适用于消防物联网系统数据交互过程中接口
4、协议的设计开发、运行管理和应用。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本标准必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本标准;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本标准。GB/T 2260 中华人民共和国行政区划代码 GB/T 47542017 国民经济行业分类 GB/T 10114 县级以下行政区划代码编制规则 GB 11643 公民身份号码 GB 26875(所有部分)城市消防远程监控系统 GB/T 281812016 公共安全视频监控联网系统信息传输、交换、控制技术要求 GB 321002015 法人和其他组织统一社会信用
5、代码编码规则 GB 50440 城市消防远程监控系统技术规范 DB33/T 2349 数字化改革 公共数据目录编制规范 DB33/T 2351 数字化改革 公共数据分类分级指南 ISO 8601 日期和时间 信息交换表示法 IETF RFC 2616 超文本传输协议-HTTP/1.1(Hypertext Transfer Protocol-HTTP/1.1)3 术语和定义 GB 26875(所有部分)和GB 50440界定的以及下列术语和定义适用于本标准。3.1 消防物联网系统 iot system for fire 利用物联网技术采集消防相关的物、人、系统和信息资源,并进行处理的系统。3.2
6、 消防物联网运营服务机构 the operation service agency of fire iot 利用物联网技术开展社会化消防运营服务的企事业单位。3.3 联网单位 networked unit 将火灾预警信息、事件预警信息和故障信息,以及物联设备运行状态传送到消防物联网运营服务平台,并能接收消防物联网运营服务平台发送的相关信息的单位。DB33/T 24772022 2 4 缩略语 下列缩略语适用于本标准。AK:接口验证序号(Access Key)AES:密码学中的高级加密标准(Aadvanced Encryption Standard)ECDH:一种基于椭圆曲线的密钥协商算法 HT
7、TP:超文本传输协议(Hyper Text Transfer Protocol)HTTPS:超文本传输安全协议(Hyper Text Transfer Protocol Over Secure Socket Layer)IP:国际互联协议(Internet Protocol)JS:一种具有函数优先的轻量级,解释型或即时编译型的编程语言(Java Script)JSON:JavaScript对象标记语言(JavaScript Object Notation)REST:表述性状态传递(Representational State Transfer)SK:密钥(Secret Key)TLS:传输层安
8、全性协议(Transport Layer Security)URI:全局资源标识符(Universal Resource Identifier)URL:统一资源定位符(Uniform Resoure Locator)UTF-8:可变长度字符编码(8-bit Unicode Transformation Forma)5 系统对接模型 组成部分 5.1 系统对接模型由上级系统和下级系统组成,上级系统应具有数据查询接口和数据推送接收接口。下级系统应具有基础资源数据,运营机构管理数据,消防物联感知数据,消防物联处置数据。系统数据架构组成应与图1相符合,下级系统业务数据具体如下:a)基础资源数据,包含联
9、网单位,住宅小区,建筑物,重点部位,物联设备、部件,消防物联网运营服务机构,运营服务机构人员等信息;b)运营机构管理数据,包含运营服务机构维保记录和运营服务机构值班记录;c)消防物联感知数据,包含运行状态、监测数据、故障信息、火灾预警信息、事件预警信息、消防视频流;d)消防物联处置数据,包含火灾预警处置信息、事件预警处置信息、故障处置信息。DB33/T 24772022 3 上级系统 数据查询接口 数据推送接口 基于 REST 的 HTTP/HTTPS 协议 下级系统 基础资源数据 消防物联感知数据 联网单位信息 住宅小区信息 建筑物信息 监控数据信息 火灾预警信息 重点部位信息 物联设备信息
10、 运营机构信息 事件预警信息 故障信息 部件信息 运营机构人员信息 消防视频流 运行状态 消防物联处置数据 运营机构管理数据 火灾预警处置信息 事件预警处置信息 故障处置信息 运营机构值班记录 运营机构维保记录 图1 系统数对接模型图 对接功能 5.2 5.2.1 下级系统应具备向上级系统提供接口以及级联功能,基于 REST 的 HTTP/HTTPS 的传输方式。上级平台应支持接收下级系统上报基础资源数据、运营机构管理数据、消防物联感知数据、消防物联处置数据,并支持以主动查询方式从下级系统获取消防基础资源数据、运营机构管理数据和消防物联感知数据、消防物联处置数据。5.2.2 上级系统和下级系统
11、应通过身份认证、传输加密、数据校验等方式确保数据传输的安全性和可用性。6 基本要求 功能要求 6.1 6.1.1 数据查询 下级系统提供全量数据和某一时间段内数据的查询接口,上级系统可通过调用该接口查询数据,数据应符合5.1中的相关规定。DB33/T 24772022 4 基础资源数据查询对应接口实现应符合7.1中的相关规定。6.1.2 数据推送 当下级系统数据出现增加、修改、删除情况时,下级系统能够实时向上级平台上报数据,数据应符合5.1中的相关规定。消防基础资源数据上报对应接口说明应符合7.2中的相关规定。6.1.3 消防视频调用 下级系统应具备消防重点部位视频的开放能力,供上级系统实时调
12、取查看。视频流的延时不超过5秒。消防安全视频调用对应接口说明应符合7.3中的相关规定。安全要求 6.2 6.2.1 安全管理要求 下级系统向上级系统提交审核的内容,审核信息至少包含请求下级系统名称,下级系统地址,统一社会信用代码,法定代表人姓名,法定代表人身份证号码,法定代表人联系电话,运营机构责任人姓名,运营机构责任人联系电话。上级系统审核通过后,向下级系统发放身份凭证。6.2.2 身份认证 上级系统和下级系统之间相互访问。基于HTTP/HTTPS时应采用符合附录A中加密的安全摘要认证方式,算法使用加密安全哈希算法HMAC-SHA256,平台提供身份凭证,获取身份密钥(AK、SK)。6.2.
13、3 数据加密 上级系统与下级系统之间在传输附录B数据元描述中L2级别及L2级别以上数据字段时,需要先加密再进行传输。HTTPS选用TLS V1.2加密协议,加密套件采用TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,数字证书采用公开可信证书或者可信的自签名X.509数字证书。6.2.4 公共数据要求 上级系统与下级系统传输公共数据应符合DB33/T 2349和DB33/T 2351。数据传输时间要求 6.3 6.3.1 数据查询要求,下级系统接收到上级系统查询请求后应在 15 秒内返回响应;
14、分页查询时,下级系统返回上级系统同一请求的响应时,数据包之间的时间间隔不得大于 500 毫秒。6.3.2 基础资源数据、运营机构管理数据上报要求,基础资源数据在发生变更或新的运营机构管理数据产生时,应在 10 秒内上报至上级系统。6.3.3 故障、事件预警、火灾预警信息上报要求,同一故障、事件预警、火灾预警信息只上报一次,下级平台在接收到物联设备上报的时间后,应在 10 秒内上报至上级系统;同一故障、事件预警、火灾预警处置信息,应在处置完成后 10 秒内上报至上级系统。6.3.4 状态数据要求,物联设备和部件状态在发生变更时,应在 10 秒内上报至上级系统。DB33/T 24772022 6.
15、3.5 监测数据上报频率要求,下级系统在采集到物联设备的监测数据时,同一物联设备应控制上报频率不小于 10 分钟。6.3.6 视频数据要求,视频流传输延时不超过 5 秒。接口要求 6.4 协议参见附录C REST,接口相对URL符合fire/*或fire/*/*。接口消息描述定义见附录D中D.1接口消息描述。接口数据信息中运营服务机构唯一编码应符合附录E中运营服务机构唯一编码规则的规定。7 接口实现 数据查询 7.1 7.1.1 数据查询流程 上级系统主动向下级系统发起数据查询请求,下级系统按请求返回数据,具体流程应与图2相符合。上级系统下级系统使用AK、SK、查询参数生成字符串TokenAP
16、OST请求查询接口,传入查询参数请求头部带上认证字符串验证认证字符串根据查询参数获取查询数据(涉及隐私则加密)返回查询数据查询失败,身份认证未通过请求身份认证成功请求身份认证失败DB33/T 24772022 6 生成认证字符串和验证认证字符串应符合附录A的A.1中的相关规定。基础资源数据在传输过程中,用于数据加密的流程和算法应符合附录A的A.2中的相关规定。不涉及隐私信息的数据可不做加密传输。7.1.2 通用查询接口参数 上级系统向下级系统查询数据,通用查询请求头参数应符合表1和通用查询请求参数应符合表2。表1 通用查询请求头参数 名称 数据类型 是否必填 默认值 说明 Client-Tok
17、en String M(无)客户端请求认证字符串 注:M为必填。表2 通用查询请求参数 名称 数据类型 是否必填 默认值 说明 startDate String O(无)起始日期,应符合ISO 8601标准 endDate String O 当前日期 截止日期,应符合ISO 8601标准 pageSize Integer M 1000 返回记录的单页数量,每次请求返回一页记录,数据结果大于一页时,需要多次请求获取。0pageSize1000 pageNo Integer M(无)页面序号,pageNo0 注:M为必填,O为非必填。上级系统向下级系统查询数据,通用查询响应头参数应符合表3和通用查
18、询返回参数应符合表4。表3 通用查询响应头参数 名称 数据类型 是否必填 默认值 说明 Server-Token String M(无)服务响应认证字符串 注:M为必填。表4 通用查询返回参数 名称 数据类型 说明 code String 返回码,0表示成功,其他值应符合附录F的F.1错误码 message String 接口执行情况说明信息 data Object 返回值对象 7.1.3 基础数据查询接口 7.1.3.1 联网单位查询接口 上级系统向下级系统查询联网单位数据,应符合表5表6。DB33/T 24772022 7 表5 联网单位查询接口 接口描述 查询与校正数据 相对URL fi
19、re/company/dataRows 方法 POST 数据提交方式(Content-Type)application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.1.2的相关规定,返回参数data字段应符合表6。表6 返回参数 data 字段 名称 数据类型 说明 rowCount Integer 返回记录数 pageCount Integer 返回页面总数(与请求参数单页数量计算获得)lists Object 数据行数组,元素是联网单位信息(company),应符合附录B的B.1。7.1.3.2 住宅小区查询接口 上级系统向下级系统查询住宅小区数据,应符合表7表8。表7
20、住宅小区查询接口 接口描述 查询与校正数据 相对URL fire/community/dataRows 方法 POST 数据提交方式(Content-Type)application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.1.2中的相关规定,返回参数data字段应符合表8。表8 返回参数 data 字段 名称 数据类型 说明 rowCount Integer 返回记录数 pageCount Integer 返回页面总数(与请求参数单页数量计算获得)lists Object 数据行数组,元素是住宅小区信息(community),应符合附录B的B.2 7.1.3.3 建筑物
21、查询接口 上级系统向下级系统查询建筑物数据,应符合表9表10。DB33/T 24772022 8 表9 建筑物查询接口 接口描述 查询与校正数据 相对URL fire/building/dataRows 方法 POST 数据提交方式(Content-Type)application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.1.2的相关规定,返回参数data字段应符合表10。表10 返回参数 data 字段 名称 数据类型 说明 rowCount Integer 返回记录数 pageCount Integer 返回页面总数(与请求参数单页数量计算获得)lists Objec
22、t 数据行数组,元素是建筑物信息(building),应符合附录B的B.3 7.1.3.4 重点部位查询接口 上级系统向下级系统查询重点部位数据,应符合表11表12。表11 重点部位查询接口 接口描述 查询与校正数据 相对URL fire/importantposition/dataRows 方法 POST 数据提交方式(Content-Type)application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.1.2的相关规定,返回参数data字段应符合表12。表12 返回参数 data 字段 名称 数据类型 说明 rowCount Integer 返回记录数 pageC
23、ount Integer 返回页面总数(与请求参数单页数量计算获得)lists Object 数据行数组,元素是重点部位数据,应符合附录B的B.4。7.1.3.5 物联设备查询接口 上级系统向下级系统查询物联设备数据,应符合表13表14。表13 物联设备查询接口 接口描述 查询与校正数据 相对URL fire/firedevice/dataRows 方法 POST 数据提交方式(Content-Type)application/json DB33/T 24772022 9 请求头参数和请求参数、响应头参数和返回参数应符合7.1.2的相关规定,返回参数data字段应符合表14。表14 返回参数
24、data 字段 名称 数据类型 说明 rowCount Integer 返回记录数 pageCount Integer 返回页面总数(与请求参数单页数量计算获得)lists Object 数据行数组,元素是物联设备信息(fireDevice),应符合附录B的B.5 7.1.3.6 部件查询接口 上级系统向下级系统查询部件数据,应符合表15表16。表15 部件查询接口 接口描述 查询与校正数据 相对URL fire/part/dataRows 方法 POST 数据提交方式(Content-Type)application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.1.2的相关
25、规定,返回参数data字段应符合表16。表16 返回参数 date 字段 名称 数据类型 说明 rowCount Integer 返回记录数 pageCount Integer 返回页面总数(与请求参数单页数量计算获得)lists Object 数据行数组,元素是部件信息(sensor),应符合附录B的B.6 7.1.3.7 运营机构查询接口 上级系统向下级系统查询消防物联网运营服务机构数据,应符合表17表18。表17 运营机构查询接口 接口描述 查询与校正数据 相对URL fire/servicecompany/dataRows 方法 POST 数据提交方式(Content-Type)app
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB33T 2477-2022 消防物联网系统对接技术规范浙江省 DB33 2477 2022 消防 联网 系统 对接 技术规范 浙江省
限制150内