国家或地方技术规范:消防物联网系统对接技术规范.pdf

举报
资源描述
ICS 35.240.01 CCS L 65 33 浙江省地方标准 DB33/T 24772022 消防物联网系统对接技术规范 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 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部分:标准化文件的结构和起草规则的规定起草。请注意本标准的某些内容可能涉及专利。本标准的发布机构不承担识别专利的责任。本标准由浙江省消防救援总队提出、归口并组织实施。本标准起草单位:中国电信股份有限公司浙江分公司、杭州海康消防科技有限公司、浙江大华技术股份有限公司、华为技术有限公司、阿里云计算有限公司、中国移动通信集团有限公司浙江分公司、杭州竟火科技有限公司。本标准主要起草人:严晓龙、金辉、黄亚东、刘涛、吕锋、李楠、庞霄波、丁诗懿、姚弋、王坚平、张旭阳、陈卫平、蔡旭东、周雁、顾孟钧、李勇、郑金荣、吴天桂、王正庭、袁惟道、杨永林、徐志春、刘新明、陈伟、莫少泽、程智慧。DB33/T 24772022 1 消防物联网系统对接技术规范 1 范围 本标准规定了消防物联网系统数据对接的系统对接模型、基本要求和接口实现。本标准适用于消防物联网系统数据交互过程中接口协议的设计开发、运行管理和应用。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本标准必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本标准;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本标准。GB/T 2260 中华人民共和国行政区划代码 GB/T 47542017 国民经济行业分类 GB/T 10114 县级以下行政区划代码编制规则 GB 11643 公民身份号码 GB 26875(所有部分)城市消防远程监控系统 GB/T 281812016 公共安全视频监控联网系统信息传输、交换、控制技术要求 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 system for fire 利用物联网技术采集消防相关的物、人、系统和信息资源,并进行处理的系统。3.2 消防物联网运营服务机构 the operation service agency of fire iot 利用物联网技术开展社会化消防运营服务的企事业单位。3.3 联网单位 networked unit 将火灾预警信息、事件预警信息和故障信息,以及物联设备运行状态传送到消防物联网运营服务平台,并能接收消防物联网运营服务平台发送的相关信息的单位。DB33/T 24772022 2 4 缩略语 下列缩略语适用于本标准。AK:接口验证序号(Access Key)AES:密码学中的高级加密标准(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:表述性状态传递(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 系统对接模型由上级系统和下级系统组成,上级系统应具有数据查询接口和数据推送接收接口。下级系统应具有基础资源数据,运营机构管理数据,消防物联感知数据,消防物联处置数据。系统数据架构组成应与图1相符合,下级系统业务数据具体如下:a)基础资源数据,包含联网单位,住宅小区,建筑物,重点部位,物联设备、部件,消防物联网运营服务机构,运营服务机构人员等信息;b)运营机构管理数据,包含运营服务机构维保记录和运营服务机构值班记录;c)消防物联感知数据,包含运行状态、监测数据、故障信息、火灾预警信息、事件预警信息、消防视频流;d)消防物联处置数据,包含火灾预警处置信息、事件预警处置信息、故障处置信息。DB33/T 24772022 3 上级系统 数据查询接口 数据推送接口 基于 REST 的 HTTP/HTTPS 协议 下级系统 基础资源数据 消防物联感知数据 联网单位信息 住宅小区信息 建筑物信息 监控数据信息 火灾预警信息 重点部位信息 物联设备信息 运营机构信息 事件预警信息 故障信息 部件信息 运营机构人员信息 消防视频流 运行状态 消防物联处置数据 运营机构管理数据 火灾预警处置信息 事件预警处置信息 故障处置信息 运营机构值班记录 运营机构维保记录 图1 系统数对接模型图 对接功能 5.2 5.2.1 下级系统应具备向上级系统提供接口以及级联功能,基于 REST 的 HTTP/HTTPS 的传输方式。上级平台应支持接收下级系统上报基础资源数据、运营机构管理数据、消防物联感知数据、消防物联处置数据,并支持以主动查询方式从下级系统获取消防基础资源数据、运营机构管理数据和消防物联感知数据、消防物联处置数据。5.2.2 上级系统和下级系统应通过身份认证、传输加密、数据校验等方式确保数据传输的安全性和可用性。6 基本要求 功能要求 6.1 6.1.1 数据查询 下级系统提供全量数据和某一时间段内数据的查询接口,上级系统可通过调用该接口查询数据,数据应符合5.1中的相关规定。DB33/T 24772022 4 基础资源数据查询对应接口实现应符合7.1中的相关规定。6.1.2 数据推送 当下级系统数据出现增加、修改、删除情况时,下级系统能够实时向上级平台上报数据,数据应符合5.1中的相关规定。消防基础资源数据上报对应接口说明应符合7.2中的相关规定。6.1.3 消防视频调用 下级系统应具备消防重点部位视频的开放能力,供上级系统实时调取查看。视频流的延时不超过5秒。消防安全视频调用对应接口说明应符合7.3中的相关规定。安全要求 6.2 6.2.1 安全管理要求 下级系统向上级系统提交审核的内容,审核信息至少包含请求下级系统名称,下级系统地址,统一社会信用代码,法定代表人姓名,法定代表人身份证号码,法定代表人联系电话,运营机构责任人姓名,运营机构责任人联系电话。上级系统审核通过后,向下级系统发放身份凭证。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,数字证书采用公开可信证书或者可信的自签名X.509数字证书。6.2.4 公共数据要求 上级系统与下级系统传输公共数据应符合DB33/T 2349和DB33/T 2351。数据传输时间要求 6.3 6.3.1 数据查询要求,下级系统接收到上级系统查询请求后应在 15 秒内返回响应;分页查询时,下级系统返回上级系统同一请求的响应时,数据包之间的时间间隔不得大于 500 毫秒。6.3.2 基础资源数据、运营机构管理数据上报要求,基础资源数据在发生变更或新的运营机构管理数据产生时,应在 10 秒内上报至上级系统。6.3.3 故障、事件预警、火灾预警信息上报要求,同一故障、事件预警、火灾预警信息只上报一次,下级平台在接收到物联设备上报的时间后,应在 10 秒内上报至上级系统;同一故障、事件预警、火灾预警处置信息,应在处置完成后 10 秒内上报至上级系统。6.3.4 状态数据要求,物联设备和部件状态在发生变更时,应在 10 秒内上报至上级系统。DB33/T 24772022 5 6.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相符合。图2 数据查询流程 上级系统下级系统使用AK、SK、查询参数生成字符串TokenAPOST请求查询接口,传入查询参数请求头部带上认证字符串验证认证字符串根据查询参数获取查询数据(涉及隐私则加密)返回查询数据查询失败,身份认证未通过请求身份认证成功请求身份认证失败DB33/T 24772022 6 生成认证字符串和验证认证字符串应符合附录A的A.1中的相关规定。基础资源数据在传输过程中,用于数据加密的流程和算法应符合附录A的A.2中的相关规定。不涉及隐私信息的数据可不做加密传输。7.1.2 通用查询接口参数 上级系统向下级系统查询数据,通用查询请求头参数应符合表1和通用查询请求参数应符合表2。表1 通用查询请求头参数 名称 数据类型 是否必填 默认值 说明 Client-Token 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和通用查询返回参数应符合表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 fire/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 住宅小区查询接口 接口描述 查询与校正数据 相对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 建筑物查询接口 上级系统向下级系统查询建筑物数据,应符合表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 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 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的相关规定,返回参数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 请求头参数和请求参数、响应头参数和返回参数应符合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/dataRows 方法 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 运营机构人员查询接口 上级系统向下级系统查询运营服务机构人员数据,应符合表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 数据行数组,元素是运营服务机构人员信息(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 返回参数 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)application/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 24772022 12 图3 数据上报流程 生成认证字符串和验证认证字符串应符合附录A的A.1中的相关规定。数据在传输过程中,用于数据加密的流程和算法应符合附录A的A.2中的相关规定。不涉及隐私信息的数据可不做加密传输。7.2.2 通用推送接口参数 下级系统数据发生变更后,需将变更信息上报至上级系统。通用推送请求头参数应符合表25和通用推送请求参数应符合表26。表25 通用推送请求头参数 名称 数据类型 是否必填 默认值 说明 Client-Token String M(无)客户端请求认证字符串 注:M为必填。下级系统上级系统使用AK、SK、加密后数据生成认证字符串POST请求数据上报接口,携带加密后数据请求头部带上认证字符串验证认证字符串响应上报成功上报失败,身份认证未通过使用密钥解密以及协商的加密算法解密被加密的数据请求身份认证成功请求身份认证失败DB33/T 24772022 13 表26 通用推送请求参数 名称 数据类型 是否必填 默认值 说明 opt_type Integer M 0 0-新增或修改,1-删除 lists Object M(无)列表数据信息应合附录B,删除时只需填对应的数据id和parent_id 注:M为必填。下级系统数据发生变更后,需将变更信息上报至上级系统,通用推送响应头参数应符合表27和通用推送返回参数应符合表2829。表27 通用推送响应头参数 名称 数据类型 是否必填 默认值 说明 Server-Token String M(无)服务响应认证字符串 注:M为必填。表28 通用推送返回参数 名称 数据类型 说明 code String 返回码,0表示成功,其他值应符合附录F的F.1错误码 message String 接口执行情况说明信息 data Object 返回值对象,内含successes和failures两个列表,分别表示添加成功和失败的数据列表 表29 返回参数 data 字段 名称 数据类型 说明 successes Object 对象数组类型,表示添加成功数据列表 failures Object 对象数据类型,表示添加失败数据列表 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 successes 字段信息 名称 数据类型 说明 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 数据提交方式(Content-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 建筑物推送接口 下级系统新建、修改、删除建筑物后,将变更信息上报至上级系统,应符合表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 字段信息 名称 数据类型 说明 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中的相关规定,返回参数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 物联设备推送接口 下级系统新建、修改、删除物联设备后,将变更信息上报至上级系统,应符合表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 物联设备唯一编码 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 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 数据提交方式(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 运营机构人员推送接口 下级系统新建、修改、删除运营机构人员后,将变更信息上报至上级系统,应符合表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 String 运营服务机构人员唯一编码 表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 请求头参数和请求参数、响应头参数和返回参数应符合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表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 事件唯一编码 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 字段信息 名称 数据类型 说明 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-Type)application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.2.2中的相关规定,返回参数successes字段应符合表64,返回参数failures字段应符合表65。表64 successes 字段信息 名称 数据类型 说明 event_id String 事件唯一编码 表65 failures 字段信息 名称 数据类型 说明 event_id String 事件唯一编码 code String 错误码,详情应符合附录F的F.1错误码 message String 错误信息 7.2.4.4 火灾预警信息推送接口 下级系统的火灾预警信息实时上报至上级系统,应符合表66表68。表66 火灾预警信息推送接口 接口描述 推送与校正数据 相对URL fire/firealarm/report 方法 POST 数据提交方式(Content-Type)application/json 请求头参数和请求参数、响应头参数和返回参数应符合7.2.2中的相关规定,
展开阅读全文
相关搜索
收藏 分享(赏)
温馨提示:
文库网所有资源均是用户自行上传分享,仅供网友学习交流,未经上传用户书面授权,请勿作他用。

当前位置:首页 > 技术资料 > 技术规范


本站链接:文库   一言   我酷   合作


客服QQ:2549714901微博号:文库网官方知乎号:文库网

经营许可证编号: 粤ICP备2021046453号世界地图

文库网官网©版权所有2025营业执照举报