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 2477 2022 消防物联 网系统对 接技术规 范 Technical Specification for Fire Internet of Things System Integration 2022-04-03 发布 2022-05-03 实施 浙江省市 场监督 管 理局 发 布 DB33/T 24772022 I 目 次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.2 5 系统对接模型.2 组成部分.2 5.1 对接功能.3 5.2 6 基本要求.3 功能要求.3

2、6.1 安全要求.4 6.2 数据传输时间要求.4 6.3 接口要求.5 6.4 7 接口实现.5 数据查询.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 公共安

5、全视频监控联网系统信息传输、交换、控制技术要求 GB 321002015 法人和其他组织统一社会信用代码编码规则 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 s

6、ystem for fire 利用物联网技术采集消防相关的物、人、系统和信息资源，并进行处理的系统。3.2 消防物 联网 运营 服务 机构 the operation service agency of fire iot 利用物联网技术开展社会化消防运营服务的企事业单位。3.3 联网单 位 networked unit 将火灾预警信息、事件预警信息和故障信息，以及物联设备运行状态传送到消防物联网运营服务平台，并能接收消防物联网运营服务平台发送的相关信息的单位。DB33/T 24772022 2 4 缩略语 下列缩略语适用于本标准。AK：接口验证序号（Access Key）AES：密码学中的高级

7、加密标准（Aadvanced Encryption Standard）ECDH：一种基于椭圆曲线的密钥协商算法 HTTP：超文本传输协议（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：表述性状态传递

8、（Representational State Transfer）SK：密钥（Secret Key）TLS：传输层安全性协议（Transport Layer Security）URI：全局资源标识符（Universal Resource Identifier）URL：统一资源定位符（Uniform Resoure Locator）UTF-8：可变长度字符编码（8-bit Unicode Transformation Forma）5 系统对 接模 型 组成部 分 5.1 系统对接模型由上级系统和下级系统组成，上级系统应具有数据查询接口和数据推送接收接口。下级系统应具有基础资源数据，运营机构管理数

9、据，消防物联感知数据，消防物联处置数据。系统数据架构组成应与图1相符合，下级系统业务数据具体如下：a)基础资源数据，包含联网单位，住宅小区，建筑物，重点部位，物联设备、部件，消防物联网运营服务机构，运营服务机构人员等信息；b)运营机构管理数据，包含运营服务机构维保记录和运营服务机构值班记录；c)消防物联感知数据，包含运行状态、监测数据、故障信息、火灾预警信息、事件预警信息、消防视频流；d)消防物联处置数据，包含火灾预警处置信息、事件预警处置信息、故障处置信息。DB33/T 24772022 3 上级系统 数据查询接口 数据推送接口 基于 REST 的 HTTP/HTTPS协议 下级系统 基础资

10、源数据 消防物联感知数据 联网单位信息 住宅小区信息 建筑物信息 监控数据信息 火灾预警信息 重点部位信息 物联设备信息 运营机构信息 事件预警信息 故障信息 部件信息 运营机构人员信息 消防视频流 运行状态 消防物联处置数据 运营机构管理数据 火灾预警处置信息 事件预警处置信息 故障处置信息 运营机构值班记录 运营机构维保记录 图1 系统数 对接 模型 图 对接功 能 5.2 5.2.1 下级系 统应 具备 向上 级系 统提供 接口 以及 级联 功能，基 于 REST 的 HTTP/HTTPS 的传 输方 式。上级平台 应支 持接 收下 级系 统上报 基础 资源 数据、运 营机构 管理 数据

11、、消防 物 联感知 数据、消防 物联 处 置数据，并支 持以 主动 查询 方式从 下级 系统 获取 消防 基础资 源数 据、运营 机构 管理数 据和 消防 物 联 感 知 数据、消 防物 联处 置数 据。5.2.2 上级系 统和下 级系 统应通 过身份 认证、传输 加密、数据校 验等方 式确 保数据 传输的 安全性 和 可用性。6 基本要 求 功能要 求 6.1 6.1.1 数据查 询 下级系统提供全量数据和某一时间段内数据的查询接口，上级系统可通过调用该接口查询数据，数据应符合5.1中的相关规定。DB33/T 24772022 4 基础资源数据查询对应接口实现应符合7.1中的相关规定。6.1

12、.2 数据推 送 当下级系统数据出现增加、修改、删除情况时，下级系统能够实时向上级平台上报数据，数据应符合5.1中的相关规定。消防基础资源数据上报对应接口说明应符合7.2中的相关规定。6.1.3 消防视 频调 用 下级系统应具备消防重点部位视频的开放能力，供上级系统实时调取查看。视频流的延时不超过5秒。消防安全视频调用对应接口说明应符合7.3中的相关规定。安全要 求 6.2 6.2.1 安全管 理要 求 下级系统向上级系统提交审核的内容，审核信息至少包含请求下级系统名称，下级系统地址，统一社会信用代码，法定代表人姓名，法定代表人身份证号码，法定代表人联系电话，运营机构责任人姓名，运营机构责任人

13、联系电话。上级系统审核通过后，向下级系统发放身份凭证。6.2.2 身份认 证 上级系统和下级系统之间相互访问。基于HTTP/HTTPS时应采用符合附录A中加密的安全摘要认证方式，算法使用加密安全哈希算法HMAC-SHA256，平台提供身份凭证，获取身份密钥（AK、SK）。6.2.3 数据加 密 上级系统与下级系统之间在传输附录B数据元描述中L2级别及L2级别以上数据字段时，需要先加密再进行传输。HTTPS选用TLS V1.2加密协议，加密套件采用TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA256，TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

14、，数字证书采用公开可信证书或者可信的自签名X.509数字证书。6.2.4 公共数 据要 求 上级系统与下级系统传输公共数据应符合DB33/T 2349和DB33/T 2351。数据传 输时 间要 求 6.3 6.3.1 数据查 询要 求，下 级系 统 接收到 上级 系统 查询 请求 后应 在15 秒内 返回 响应；分页查 询时，下级系统返 回上 级系 统同 一请 求的响 应时，数 据包 之间 的时间 间隔 不得 大 于 500 毫秒。6.3.2 基础资 源数据、运 营机构 管理数 据上报 要求，基础 资源数 据在发 生变 更或新 的运营 机构管 理 数据产生 时，应 在 10 秒内 上 报至上

15、 级系 统。6.3.3 故障、事件预 警、火灾预 警信息 上报要 求，同一故 障、事 件预警、火 灾预警 信息只 上报一 次，下级平 台在 接收 到物 联设 备上报 的时 间后，应 在 10 秒内上 报至 上级 系统；同 一故障、事 件预 警、火 灾预警处 置信 息，应在 处置 完成 后 10 秒内 上报 至上 级 系统。6.3.4 状态数 据要 求，物联 设备 和部件 状态 在发 生变 更时，应 在10 秒内 上报 至上 级 系统。DB33/T 24772022 5 6.3.5 监测数 据上报 频率 要求，下级系 统在采 集到 物联设 备的监 测数据 时，同一物 联设备 应控制 上 报频率不

16、 小 于10 分钟。6.3.6 视频数 据要 求，视频 流传 输延时 不超 过 5 秒。接口要 求 6.4 协议参见附录C REST，接口相对URL符合fire/*或fire/*/*。接口消息描述定义见附录D中D.1接口消息描述。接口数据信息中运营服务机构唯一编码应符合附录E中运营服务机构唯一编码规则的规定。7 接口实 现 数据查 询 7.1 7.1.1 数据查 询流 程 上级系统主动向下级系统发起数据查询请求，下级系统按请求返回数据，具体流程应与图2相符合。图2 数据查 询流 程 上级系统 下级系统使用AK、SK、查询参数生成字符串TokenAPOST请求查询接口，传入查询参数请求头部带上认

17、证字符串验证认证字符串根据查询参数获取查询数据（涉及隐私则加密）返回查询数据查询失败，身份认证未通过请求身份认证成功请求身份认证失败DB33/T 24772022 6 生成认证字符串和验证认证字符串应符合附录A的A.1中的相关规定。基础资源数据在传输过程中，用于数据加密的流程和算法应符合附录A的A.2中的相关规定。不涉及隐私信息的数据可不做加密传输。7.1.2 通用查 询接 口参 数 上级系统向下级系统查询数据，通用查询请求头参数应符合表1和通用查询请求参数应符合表2。表1 通用查 询请 求头 参数 名称 数据类型 是否必填 默认值 说明 Client-Token String M(无)客户端

18、请求认证字符串 注：M为必填。表2 通用查 询请 求参 数 名称 数据类型 是否必填 默认值 说明 startDate String O(无)起始日期，应符合ISO 8601标准 endDate String O 当前日期 截止日期，应符合ISO 8601标准 pageSize Integer M 1000 返回记录的单页数量，每次请求返回一页记录，数据结果大于一页时，需要多次请求获取。0pageSize1000 pageNo Integer M(无)页面序号，pageNo0 注：M为必填，O为非必填。上级系统向下级系统查询数据，通用查询响应头参数应符合表3和通用查询返回参数应符合表4。表3

19、通用查 询响 应头 参数 名称 数据类型 是否必填 默认值 说明 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 f

20、ire/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表

21、8。表7 住宅小 区查 询接 口 接口描述 查询与校正数据 相对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.

22、1.3.3 建筑物 查询 接口 上级系统向下级系统查询建筑物数据，应符合表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 返回页面总数(与请求参数单页数量计算获

23、得)lists Object 数据行数组，元素是建筑物信息（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

24、Integer 返回记录数 pageCount 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的相关规定，返

25、回参数data字段应符合表14。表14 返回参 数 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 请求

26、头参数和请求参数、响应头参数和返回参数应符合7.1.2的相关规定，返回参数data字段应符合表16。表16 返回参 数 date 字段 名称 数据类型 说明 rowCount Integer 返回记录数 pageCount Integer 返回页面总数(与请求参数单页数量计算获得)lists Object 数据行数组，元素是部件信息（sensor），应符合附录B的B.6 7.1.3.7 运营机 构查 询接 口 上级系统向下级系统查询消防物联网运营服务机构数据，应符合表17表18。表17 运营机 构查 询接 口 接口描述 查询与校正数据 相对URL fire/servicecompany/dat

27、aRows 方法 POST 数据提交方式（Content-Type）application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.1.2的相关规定，返回参数data字段应符合表18。DB33/T 24772022 10 表18 返回参 数data 字段 名称 数据类型 说明 rowCount Integer 返回记录数 pageCount Integer 返回页面总数(与请求参数单页数量计算获得)lists Object 数据行数组，元素是消防物联网运营服务机构信息（serviceagency），应符合附录B的B.7 7.1.3.8 运营机 构人 员查 询接 口 上级系

28、统向下级系统查询运营服务机构人员数据，应符合表19表20。表19 运营机 构人 员查 询接 口 接口描述 查询与校正数据 相对URL fire/person/dataRows 方法 POST 数据提交方式（Content-Type）application/json 请求头参数和请求参数、响应头和返回参数应符合7.1.2中的相关规定，返回参数data字段应符合表20。表20 返回参 数data 字段 名称 数据类型 说明 rowCount Integer 返回记录数 pageCount Integer 返回页面总数(与请求参数单页数量计算获得)lists Object 数据行数组，元素是运营服务

29、机构人员信息（person），应符合附录B的B.8 7.1.4 运营机 构管 理数 据查 询接 口 7.1.4.1 运营机 构维 保记 录查 询接 口 上级系统向下级系统查询运营机构维保记录数据，应符合表21表22。表21 运营机 构维 保记 录查 询接 口 接口描述 查询与校正数据 相对URL fire/maintenance/dataRows 方法 POST 数据提交方式（Content-Type）application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.1.2中的相关规定，返回参数data字段应符合表22。DB33/T 24772022 11 表22 返回参

30、数 data 字段 名称 数据类型 说明 rowCount Integer 返回记录数 pageCount Integer 返回页面总数(与请求参数单页数量计算获得)lists Object 数据行数组，元素是运营机构维保记录（maintenance），应符合附录B的B.17 7.1.4.2 运营机 构值 班记 录查 询接 口 上级系统向下级系统查询运营机构值班记录数据，应符合表23表24。表23 运营机 构值 班记 录查 询接 口 接口描述 查询与校正数据 相对URL fire/dutyshift/dataRows 方法 POST 数据提交方式（Content-Type）applicatio

31、n/json 请求头参数和请求参数、响应头参数和返回参数应符合7.1.2中的相关规定，返回参数data字段应符合表24。表24 返回参 数 data 字段 名称 数据类型 说明 rowCount Integer 返回记录数 pageCount Integer 返回页面总数(与请求参数单页数量计算获得)lists Object 数据行数组，元素是运营机构值班记录信息（dutyShift），应符合附录B的B.18 数据推 送 7.2 7.2.1 数据推 送流 程 当下级系统出现数据增加、修改、删除情况时，下级系统通过http接口实时向上级系统上报数据。具体流程应符合图3。DB33/T 247720

32、22 12 图3 数据上 报流 程 生成认证字符串和验证认证字符串应符合附录A的A.1中的相关规定。数据在传输过程中，用于数据加密的流程和算法应符合附录A的A.2中的相关规定。不涉及隐私信息的数据可不做加密传输。7.2.2 通用推 送接 口参 数 下级系统数据发生变更后，需将变更信息上报至上级系统。通用推送请求头参数应符合表25和通用推送请求参数应符合表26。表25 通用推 送请 求头 参数 名称 数据类型 是否必填 默认值 说明 Client-Token String M(无)客户端请求认证字符串 注：M为必填。下级系统 上级系统使用AK、SK、加密后数据生成认证字符串POST请求数据上报接

33、口，携带加密后数据请求头部带上认证字符串验证认证字符串响应上报成功上报失败，身份认证未通过使用密钥解密以及协商的加密算法解密被加密的数据请求身份认证成功请求身份认证失败DB33/T 24772022 13 表26 通用推 送请 求参 数 名称 数据类型 是否必填 默认值 说明 opt_type Integer M 0 0-新增或修改，1-删除 lists Object M(无)列表数据信息应合附录B，删除时只需填对应的数据id和parent_id 注：M为必填。下级系统数据发生变更后，需将变更信息上报至上级系统，通用推送响应头参数应符合表27和通用推送返回参数应符合表2829。表27 通用推

34、送响 应头 参数 名称 数据类型 是否必填 默认值 说明 Server-Token String M(无)服务响应认证字符串 注：M为必填。表28 通用推 送返 回参 数 名称 数据类型 说明 code String 返回码，0表示成功，其他值应符合附录F的F.1错误码 message String 接口执行情况说明信息 data Object 返回值对象，内含successes和failures两个列表，分别表示添加成功和失败的数据列表 表29 返回参 数 data 字段 名称 数据类型 说明 successes Object 对象数组类型，表示添加成功数据列表 failures Objec

35、t 对象数据类型，表示添加失败数据列表 7.2.3 基础数 据推 送 7.2.3.1 联网单 位推 送接 口 下级系统新建、修改、删除联网单位后，将变更信息上报至上级系统，应符合表30表32。表30 联网单 位推 送接 口 接口描述 推送与校正数据 相对URL fire/company/update 方法 POST 数据提交方式（Content-Type）application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.2.2中的相关规定，返回参数successes字段应符合表31，返回参数failures字段应符合表32。DB33/T 24772022 14 表31 su

36、ccesses 字段 信息 名称 数据类型 说明 company_id String 联网单位唯一编码 表32 failures 字段 信息 名称 数据类型 说明 company_id String 联网单位唯一编码 code String 错误码，详情应符合附录F的F.1错误码 message String 错误信息 7.2.3.2 住宅小 区推 送接 口 下级系统新建、修改、删除住宅小区后，将变更信息上报至上级系统，应符合表33表35。表33 住宅小 区推 送接 口 接口描述 推送与校正数据 相对URL fire/community/update 方法 POST 数据提交方式（Conten

37、t-Type）application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.2.2中的相关规定，返回参数successes字段应符合表34，返回参数failures字段应符合表35。表34 successes 字段 信息 名称 数据类型 说明 community_id String 住宅小区唯一编码 表35 failures 字段 信息 名称 数据类型 说明 community_id String 住宅小区唯一编码 code String 错误码，详情应符合附录F的F.1错误码 message String 错误信息 DB33/T 24772022 15 7.2.3.3

38、 建筑物 推送 接口 下级系统新建、修改、删除建筑物后，将变更信息上报至上级系统，应符合表36表38。表36 建筑物 推送 接口 接口描述 推送与校正数据 相对URL fire/building/update 方法 POST 数据提交方式（Content-Type）application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.2.2中的相关规定，返回参数successes字段应符合表37，返回参数failures字段应符合表38。表37 successes 字段 信息 名称 数据类型 说明 building_id String 建筑物唯一编码 表38 failures

39、字段 信息 名称 数据类型 说明 building_id String 建筑物唯一编码 code String 错误码，详情应符合附录F的F.1错误码 message String 错误信息 7.2.3.4 重点部 位推 送接 口 下级系统新建、修改、删除重点部位后，将变更信息上报至上级系统，应符合表39表41。表39 重点部 位推 送接 口 接口描述 推送与校正数据 相对URL fire/importantposition/update 方法 POST 数据提交方式（Content-Type）application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.2.2中的相关

40、规定，返回参数successes字段应符合表40，返回参数failures字段应符合表41。表40 successes 字段 信息 名称 数据类型 说明 importantposition_id String 重点部位唯一编码 DB33/T 24772022 16 表41 failures 字段 信息 名称 数据类型 说明 importantposition_id String 重点部位唯一编码 code String 错误码，详情应符合附录F的F.1错误码 message String 错误信息 7.2.3.5 物联设 备推 送接 口 下级系统新建、修改、删除物联设备后，将变更信息上报至上级

41、系统，应符合表42表44。表42 物联设 备推 送接 口 接口描述 推送与校正数据 相对URL fire/device/update 方法 POST 数据提交方式（Content-Type）application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.2.2中的相关规定，返回参数successes字段应符合表43，返回参数failures字段应符合表44。表43 successes 字段 信息 名称 数据类型 说明 device_id String 物联设备唯一编码 表44 failures 字段 信息 名称 数据类型 说明 device_id String 物联设备唯

42、一编码 code String 错误码，详情应符合附录F的F.1错误码 message String 错误信息 7.2.3.6 部件推 送接 口 下级系统新建、修改、删除部件后，将变更信息上报至上级系统，应符合表45表47。表45 部件推 送接 口 接口描述 推送与校正数据 相对URL fire/part/update 方法 POST 数据提交方式（Content-Type）application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.2.2中的相关规定，返回参数successes字段应符合表46，返回参数failures字段应符合表47。DB33/T 24772022

43、 17 表46 successes 字段 信息 名称 数据类型 说明 part_id String 部件唯一编码 表47 failures 字段 信息 名称 数据类型 说明 part_id String 部件唯一编码 code String 错误码，详情应符合附录F的F.1错误码 message String 错误信息 7.2.3.7 运营机 构推 送接 口 上级系统新建、修改、删除运营机构信息后，将变更信息上报至下级系统，应符合表48表50。表48 运营机 构推 送接 口 接口描述 推送与校正数据 相对URL fire/servicecompany/update 方法 POST 数据提交方式

44、（Content-Type）application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.2.2中的相关规定，返回参数successes字段应符合表49，返回参数failures字段应符合表50。表49 successes 字段 信息 名称 数据类型 说明 parent_id String 消防物联网运营服务机构唯一编码 表50 failures 字段 信息 名称 数据类型 说明 parent_id String 消防物联网运营服务机构唯一编码 code String 错误码，详情应符合附录F的F.1错误码 message String 错误信息 7.2.3.8 运营机

45、 构人 员推 送接 口 下级系统新建、修改、删除运营机构人员后，将变更信息上报至上级系统，应符合表51表53。表51 运营机 构人 员推 送接 口 接口描述 推送与校正数据 相对URL fire/person/update 方法 POST 数据提交方式（Content-Type）application/json DB33/T 24772022 18 请求头参数和请求参数、响应头参数和返回参数应符合7.2.2中的相关规定，返回参数successes字段应符合表52，返回参数failures字段应符合表53。表52 successes 字段 信息 名称 数据类型 说明 person_id Stri

46、ng 运营服务机构人员唯一编码 表53 failures 字段 信息 名称 数据类型 说明 person_id String 运营服务机构人员唯一编码 code String 错误码，详情应符合附录F的F.1错误码 message String 错误信息 7.2.3.9 物联设 备 运 行状 态推 送接 口 下级系统的物联设备运行状态实时上报至上级系统，应符合表54表56。表54 物联设 备运 行状 态推 送接 口 接口描述 推送与校正数据 相对URL fire/devicestate/report 方法 POST 数据提交方式（Content-Type）application/json 请求

47、头参数和请求参数、响应头参数和返回参数应符合7.2.2中的相关规定，返回参数successes字段应符合表55，返回参数failures字段应符合表56。表55 successes 字段 信息 名称 数据类型 说明 event_id String 事件唯一编码 表56 failures 字段 信息 名称 数据类型 说明 event_id String 事件唯一编码 code String 错误码，详情应符合附录F的F.1错误码 message String 错误信息 7.2.4 物联感 知数 据推 送 7.2.4.1 监测数 据推 送接 口 下级系统的监测数据实时上报至上级系统，应符合表57表

48、59。DB33/T 24772022 19 表57 监测数 据推 送接 口 接口描述 推送与校正数据 相对URL fire/monitor/report 方法 POST 数据提交方式（Content-Type）application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.2.2中的相关规定，返回参数successes字段应符合表58，返回参数failures字段应符合表59。表58 successes 字段 信息 名称 数据类型 说明 event_id String 事件唯一编码 表59 failures 字段 信息 名称 数据类型 说明 event_id String

49、 事件唯一编码 code String 错误码，详情应符合附录F的F.1错误码 message String 错误信息 7.2.4.2 故障信 息推 送接 口 下级系统的故障信息实时上报至上级系统，应符合表60表62。表60 故障信 息推 送接 口 接口描述 推送与校正数据 相对URL fire/fault/report 方法 POST 数据提交方式（Content-Type）application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.2.2中的相关规定，返回参数successes字段应符合表61，返回参数failures字段应符合表62。表61 successes

50、字段 信息 名称 数据类型 说明 event_id String 事件唯一编码 表62 failures 字段 信息 名称 数据类型 说明 event_id String 事件唯一编码 code String 错误码，详情应符合附录F的F.1错误码 message String 错误信息 DB33/T 24772022 20 7.2.4.3 事件预 警信 息推 送接 口 下级系统的事件预警信息实时上报至上级系统，应符合表63表65。表63 事件预 警信 息推 送接 口 接口描述 推送与校正数据 相对URL fire/warning/report 方法 POST 数据提交方式（Content-T