消防物联网系统对接技术规范(浙江省)资料下载.pdf
《消防物联网系统对接技术规范(浙江省)资料下载.pdf》由会员分享,可在线阅读,更多相关《消防物联网系统对接技术规范(浙江省)资料下载.pdf(81页珍藏版)》请在冰豆网上搜索。
2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本标准必不可少的条款。
其中,注日期的引用文件,仅该日期对应的版本适用于本标准;
不注日期的引用文件,其最新版本(包括所有的修改单)适用于本标准。
GB/T2260中华人民共和国行政区划代码GB/T47542017国民经济行业分类GB/T10114县级以下行政区划代码编制规则GB11643公民身份号码GB26875(所有部分)城市消防远程监控系统GB/T281812016公共安全视频监控联网系统信息传输、交换、控制技术要求GB321002015法人和其他组织统一社会信用代码编码规则GB50440城市消防远程监控系统技术规范DB33/T2349数字化改革公共数据目录编制规范DB33/T2351数字化改革公共数据分类分级指南ISO8601日期和时间信息交换表示法IETFRFC2616超文本传输协议-HTTP/1.1(HypertextTransferProtocol-HTTP/1.1)3术语和定义GB26875(所有部分)和GB50440界定的以及下列术语和定义适用于本标准。
3.1消防物联网系统iotsystemforfire利用物联网技术采集消防相关的物、人、系统和信息资源,并进行处理的系统。
3.2消防物联网运营服务机构theoperationserviceagencyoffireiot利用物联网技术开展社会化消防运营服务的企事业单位。
3.3联网单位networkedunit将火灾预警信息、事件预警信息和故障信息,以及物联设备运行状态传送到消防物联网运营服务平台,并能接收消防物联网运营服务平台发送的相关信息的单位。
DB33/T2477202224缩略语下列缩略语适用于本标准。
AK:
接口验证序号(AccessKey)AES:
密码学中的高级加密标准(AadvancedEncryptionStandard)ECDH:
一种基于椭圆曲线的密钥协商算法HTTP:
超文本传输协议(HyperTextTransferProtocol)HTTPS:
超文本传输安全协议(HyperTextTransferProtocolOverSecureSocketLayer)IP:
国际互联协议(InternetProtocol)JS:
一种具有函数优先的轻量级,解释型或即时编译型的编程语言(JavaScript)JSON:
JavaScript对象标记语言(JavaScriptObjectNotation)REST:
表述性状态传递(RepresentationalStateTransfer)SK:
密钥(SecretKey)TLS:
传输层安全性协议(TransportLayerSecurity)URI:
全局资源标识符(UniversalResourceIdentifier)URL:
统一资源定位符(UniformResoureLocator)UTF-8:
可变长度字符编码(8-bitUnicodeTransformationForma)5系统对接模型组成部分5.1系统对接模型由上级系统和下级系统组成,上级系统应具有数据查询接口和数据推送接收接口。
下级系统应具有基础资源数据,运营机构管理数据,消防物联感知数据,消防物联处置数据。
系统数据架构组成应与图1相符合,下级系统业务数据具体如下:
a)基础资源数据,包含联网单位,住宅小区,建筑物,重点部位,物联设备、部件,消防物联网运营服务机构,运营服务机构人员等信息;
b)运营机构管理数据,包含运营服务机构维保记录和运营服务机构值班记录;
c)消防物联感知数据,包含运行状态、监测数据、故障信息、火灾预警信息、事件预警信息、消防视频流;
d)消防物联处置数据,包含火灾预警处置信息、事件预警处置信息、故障处置信息。
DB33/T247720223上级系统数据查询接口数据推送接口基于REST的HTTP/HTTPS协议下级系统基础资源数据消防物联感知数据联网单位信息住宅小区信息建筑物信息监控数据信息火灾预警信息重点部位信息物联设备信息运营机构信息事件预警信息故障信息部件信息运营机构人员信息消防视频流运行状态消防物联处置数据运营机构管理数据火灾预警处置信息事件预警处置信息故障处置信息运营机构值班记录运营机构维保记录图1系统数对接模型图对接功能5.25.2.1下级系统应具备向上级系统提供接口以及级联功能,基于REST的HTTP/HTTPS的传输方式。
上级平台应支持接收下级系统上报基础资源数据、运营机构管理数据、消防物联感知数据、消防物联处置数据,并支持以主动查询方式从下级系统获取消防基础资源数据、运营机构管理数据和消防物联感知数据、消防物联处置数据。
5.2.2上级系统和下级系统应通过身份认证、传输加密、数据校验等方式确保数据传输的安全性和可用性。
6基本要求功能要求6.16.1.1数据查询下级系统提供全量数据和某一时间段内数据的查询接口,上级系统可通过调用该接口查询数据,数据应符合5.1中的相关规定。
DB33/T247720224基础资源数据查询对应接口实现应符合7.1中的相关规定。
6.1.2数据推送当下级系统数据出现增加、修改、删除情况时,下级系统能够实时向上级平台上报数据,数据应符合5.1中的相关规定。
消防基础资源数据上报对应接口说明应符合7.2中的相关规定。
6.1.3消防视频调用下级系统应具备消防重点部位视频的开放能力,供上级系统实时调取查看。
视频流的延时不超过5秒。
消防安全视频调用对应接口说明应符合7.3中的相关规定。
安全要求6.26.2.1安全管理要求下级系统向上级系统提交审核的内容,审核信息至少包含请求下级系统名称,下级系统地址,统一社会信用代码,法定代表人姓名,法定代表人身份证号码,法定代表人联系电话,运营机构责任人姓名,运营机构责任人联系电话。
上级系统审核通过后,向下级系统发放身份凭证。
6.2.2身份认证上级系统和下级系统之间相互访问。
基于HTTP/HTTPS时应采用符合附录A中加密的安全摘要认证方式,算法使用加密安全哈希算法HMAC-SHA256,平台提供身份凭证,获取身份密钥(AK、SK)。
6.2.3数据加密上级系统与下级系统之间在传输附录B数据元描述中L2级别及L2级别以上数据字段时,需要先加密再进行传输。
HTTPS选用TLSV1.2加密协议,加密套件采用TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,数字证书采用公开可信证书或者可信的自签名X.509数字证书。
6.2.4公共数据要求上级系统与下级系统传输公共数据应符合DB33/T2349和DB33/T2351。
数据传输时间要求6.36.3.1数据查询要求,下级系统接收到上级系统查询请求后应在15秒内返回响应;
分页查询时,下级系统返回上级系统同一请求的响应时,数据包之间的时间间隔不得大于500毫秒。
6.3.2基础资源数据、运营机构管理数据上报要求,基础资源数据在发生变更或新的运营机构管理数据产生时,应在10秒内上报至上级系统。
6.3.3故障、事件预警、火灾预警信息上报要求,同一故障、事件预警、火灾预警信息只上报一次,下级平台在接收到物联设备上报的时间后,应在10秒内上报至上级系统;
同一故障、事件预警、火灾预警处置信息,应在处置完成后10秒内上报至上级系统。
6.3.4状态数据要求,物联设备和部件状态在发生变更时,应在10秒内上报至上级系统。
DB33/T2477202256.3.5监测数据上报频率要求,下级系统在采集到物联设备的监测数据时,同一物联设备应控制上报频率不小于10分钟。
6.3.6视频数据要求,视频流传输延时不超过5秒。
接口要求6.4协议参见附录CREST,接口相对URL符合fire/*或fire/*/*。
接口消息描述定义见附录D中D.1接口消息描述。
接口数据信息中运营服务机构唯一编码应符合附录E中运营服务机构唯一编码规则的规定。
7接口实现数据查询7.17.1.1数据查询流程上级系统主动向下级系统发起数据查询请求,下级系统按请求返回数据,具体流程应与图2相符合。
图2数据查询流程上级系统下级系统使用AK、SK、查询参数生成字符串TokenAPOST请求查询接口,传入查询参数请求头部带上认证字符串验证认证字符串根据查询参数获取查询数据(涉及隐私则加密)返回查询数据查询失败,身份认证未通过请求身份认证成功请求身份认证失败DB33/T247720226生成认证字符串和验证认证字符串应符合附录A的A.1中的相关规定。
基础资源数据在传输过程中,用于数据加密的流程和算法应符合附录A的A.2中的相关规定。
不涉及隐私信息的数据可不做加密传输。
7.1.2通用查询接口参数上级系统向下级系统查询数据,通用查询请求头参数应符合表1和通用查询请求参数应符合表2。
表1通用查询请求头参数名称数据类型是否必填默认值说明Client-TokenStringM(无)客户端请求认证字符串注:
M为必填。
表2通用查询请求参数名称数据类型是否必填默认值说明startDateStringO(无)起始日期,应符合ISO8601标准endDateStringO当前日期截止日期,应符合ISO8601标准pageSizeIntegerM1000返回记录的单页数量,每次请求返回一页记录,数据结果大于一页时,需要多次请求获取。
0pageSize1000pageNoIntegerM(无)页面序号,pageNo0注:
M为必填,O为非必填。
上级系统向下级系统查询数据,通用查询响应头参数应符合表3和通用查询返回参数应符合表4。
表3通用查询响应头参数名称数据类型是否必填默认值说明Server-TokenStringM(无)服务响应认证字符串注:
表4通用查询返回参数名称数据类型说明codeString返回码,0表示成功,其他值应符合附录F的F.1错误码messageString接口执行情况说明信息dataObject返回值对象7.1.3基础数据查询接口7.1.3.1联网单位查询接口上级系统向下级系统查询联网单位数据,应符合表5表6。
DB33/T247720227表5联网单位查询接口接口描述查询与校正数据相对URLfire/company/dataRows方法POST数据提交方式(Content-Type)application/json请求头参数和请求参数、响应头参数和返回参数应符合7.1.2的相关规定,返回参数data字段应符合表6。
表6返回参数data字段名称数据类型说明rowCountInteger返回记录数pageCountInteger返回页面总数(与请求参数单页数量计算获得)listsObject数据行数组,元素是联网单位信息(company),应符合附录B的B.1。
7.1.3.2住宅小区查询接口上级系统向下级系统查询住宅小区数据,应符合表7表8。
表7住宅小区查询接口接口描述查询与校正数据相对URLfire/community/dataRows方法POST数据提交方式(Content-Type)application/json请求头参数和请求参数、响应头参数和返回参数应符合7.1.2中的相关规定,返回参数data字段应符合表8。
表8返回参数data字段名称数据类型说明rowCountInteger返回记录数pageCountInteger返回页面总数(与请求参数单页数量计算获得)listsObject数据行数组,元素是住宅小区信息(community),应符合附录B的B.27.1.3.3建筑物查询接口上级系统向下级系统查询建筑物数据,应符合表9表10。
DB33/T247720228表9建筑物查询接口接口描述查询与校正数据相对URLfire/building/dataRows方法POST数据提交方式(Content-Type)application/json请求头参数和请求参数、响应头参数和返回参数应符合7.1.2的相关规定,返回参数data字段应符合表10。
表10返回参数data字段名称数据类型说明rowCountInteger返回记录数pageCountInteger返回页面总数(与请求参数单页数量计算获得)listsObject数据行数组,元素是建筑物信息(building),应符合附录B的B.37.1.3.4重点部位查询接口上级系统向下级系统查询重点部位数据,应符合表11表12。
表11重点部位查询接口接口描述查询与校正数据相对URLfire/importantposition/dataRows方法POST数据提交方式(Content-Type)application/json请求头参数和请求参数、响应头参数和返回参数应符合7.1.2的相关规定,返回参数data字段应符合表12。
表12返回参数data字段名称数据类型说明rowCountInteger返回记录数pageCountInteger返回页面总数(与请求参数单页数量计算获得)listsObject数据行数组,元素是重点部位数据,应符合附录B的B.4。
7.1.3.5物联设备查询接口上级系统向下级系统查询物联设备数据,应符合表13表14。
表13物联设备查询接口接口描述查询与校正数据相对URLfire/firedevice/dataRows方法POST数据提交方式(Content-Type)application/jsonDB33/T247720229请求头参数和请求参数、响应头参数和返回参数应符合7.1.2的相关规定,返回参数data字段应符合表14。
表14返回参数data字段名称数据类型说明rowCountInteger返回记录数pageCountInteger返回页面总数(与请求参数单页数量计算获得)listsObject数据行数组,元素是物联设备信息(fireDevice),应符合附录B的B.57.1.3.6部件查询接口上级系统向下级系统查询部件数据,应符合表15表16。
表15部件查询接口接口描述查询与校正数据相对URLfire/part/dataRows方法POST数据提交方式(Content-Type)application/json请求头参数和请求参数、响应头参数和返回参数应符合7.1.2的相关规定,返回参数data字段应符合表16。
表16返回参数date字段名称数据类型说明rowCountInteger返回记录数pageCountInteger返回页面总数(与请求参数单页数量计算获得)listsObject数据行数组,元素是部件信息(sensor),应符合附录B的B.67.1.3.7运营机构查询接口上级系统向下级系统查询消防物联网运营服务机构数据,应符合表17表18。
表17运营机构查询接口接口描述查询与校正数据相对URLfire/servicecompany/dataRows方法POST数据提交方式(Content-Type)application/json请求头参数和请求参数、响应头参数和返回参数应符合7.1.2的相关规定,返回参数data字段应符合表18。
DB33/T2477202210表18返回参数data字段名称数据类型说明rowCountInteger返回记录数pageCountInteger返回页面总数(与请求参数单页数量计算获得)listsObject数据行数组,元素是消防物联网运营服务机构信息(serviceagency),应符合附录B的B.77.1.3.8运营机构人员查询接口上级系统向下级系统查询运营服务机构人员数据,应符合表19表20。
表19运营机构人员查询接口接口描述查询与校正数据相对URLfire/person/dataRows方法POST数据提交方式(Content-Type)application/json请求头参数和请求参数、响应头和返回参数应符合7.1.2中的相关规定,返回参数data字段应符合表20。
表20返回参数data字段名称数据类型说明rowCountInteger返回记录数pageCountInteger返回页面总数(与请求参数单页数量计算获得)listsObject数据行数组,元素是运营服务机构人员信息(person),应符合附录B的B.87.1.4运营机构管理数据查询接口7.1.4.1运营机构维保记录查询接口上级系统向下级系统查询运营机构维保记录数据,应符合表21表22。
表21运营机构维保记录查询接口接口描述查询与校正数据相对URLfire/maintenance/dataRows方法POST数据提交方式(Content-Type)application/json请求头参数和请求参数、响应头参数和返回参数应符合7.1.2中的相关规定,返回参数data字段应符合表22。
DB33/T2477202211表22返回参数data字段名称数据类型说明rowCountInteger返回记录数pageCountInteger返回页面总数(与请求参数单页数量计算获得)listsObject数据行数组,元素是运营机构维保记录(maintenance),应符合附录B的B.177.1.4.2运营机构值班记录查询接口上级系统向下级系统查询运营机构值班记录数据,应符合表23表24。
表23运营机构值班记录查询接口接口描述查询与校正数据相对URLfire/dutyshift/dataRows方法POST数据提交方式(Content-Type)application/json请求头参数和请求参数、响应头参数和返回参数应符合7.1.2中的相关规定,返回参数data字段应符合表24。
表24返回参数data字段名称数据类型说明rowCountInteger返回记录数pageCountInteger返回页面总数(与请求参数单页数量计算获得)listsObject数据行数组,元素是运营机构值班记录信息(dutyShift),应符合附录B的B.18数据推送7.27.2.1数据推送流程当下级系统出现数据增加、修改、删除情况时,下级系统通过http接口实时向上级系统上报数据。
具体流程应符合图3。
DB33/T2477202212图3数据上报流程生成认证字符串和验证认证字符串应符合附录A的A.1中的相关规定。
数据在传输过程中,用于数据加密的流程和算法应符合附录A的A.2中的相关规定。
7.2.2通用推送接口参数下级系统数据发生变更后,需将变更信息上报至上级系统。
通用推送请求头参数应符合表25和通用推送请求参数应符合表26。
表25通用推送请求头参数名称数据类型是否必填默认值说明Client-TokenStringM(无)客户端请求认证字符串注:
下级系统上级系统使用AK、SK、加密后数据生成认证字符串POST请求数据上报接口,携带加密后数据请求头部带上认证字符串验证认证字符串响应上报成功上报失败,身份认证未通过使用密钥解密以及协商的加密算法解密被加密的数据请求身份认证成功请求身份认证失败DB33/T2477202213表26通用推送请求参数名称数据类型是否必填默认值说明opt_typeIntegerM00-新增或修改,1-删除listsObjectM(无)列表数据信息应合附录B,删除时只需填对应的数据id和parent_id注:
下级系统数据发生变更后,需将变更信息上报至上级系统,通用推送响应头参数应符合表27和通用推送返回参数应符合表2829。
表27通用推送响应头参数名称数据类型是否必填默认值说明Server-TokenStringM(无)服务响应认证字符串注:
表28通用推送返回参数名称数据类型说明codeString返回码,0表示成功,其他值应符合附录F的F.1错误码messageString接口执行情况说明信息dataObject返回值对象,内含successes和failures两个列表,分别表示添加成功和失败的数据列表表29返回参数data字段名称数据类型说明successesObject对象数组类型,表示添加成功数据列表failuresObject对象数据类型,表示添加失败数据列表7.2.3基础数据推送7.2.3.1联网单位推送接口下级系统新建、修改、删除联网单位后,将变更信息上报至上级系统,应符合表30表32。
表30联网单位推送接口接口描述推送与校正数据相对URLfire/company/upda