城市消防远程监控系统第8部分：监控中心对外数据交换协议 GB/T26875.8-2015

master

2024-02-13

国家标准
标准型式:	中华人民共和国国家标准-推荐标准
发布日期:	2015年06月02日
实施日期:	2016年02月01日

前言

中华人民共和国国家标准
城市消防远程监控系统第8部分：监控中心对外数据交换协议
Remote-monitoring system of urban fire protection—
Part 8:External data exchange protocol for monitoring center
GB/T 26875.8-2015
发布部门：中华人民共和国国家质量监督检验检疫总局
中国国家标准化管理委员会
发布日期：2015年06月02日
实施日期：2016年02月01日

GB/26875《城市消防远程监控系统》分为以下八个部分：
——第1部分：用户信息传输装置；
    ——第2部分：通信服务器软件功能要求；
    ——第3部分：报警传输网络通信协议；
    ——第4部分：基本数据项；
    ——第5部分：受理软件功能要求；
    ——第6部分：信息管理软件功能要求；
    ——第7部分：消防设施维护管理软件功能要求；
    ——第8部分：监控中心对外数据交换协议。
    本部分为GB/26875的第8部分。
    本部分按照GB/T 1.1-2009给出的规则起草。
    本部分由中华人民共和国公安部提出。
    本部分由全国消防标准化技术委员会(SAC/TC 113)归口。
    本部分负责起草单位：公安部沈阳消防研究所。
    本部分参加起草单位：深圳市赋安安全系统有限公司、万盛(中国)科技有限公司、海湾安全技术有限公司。
    本部分主要起草人：李志刚、王军、张迪、杨树峰、刘海霞、裴建国、齐宝金、仝瑞涛、赵海荣张磊、杜阳、乔培玉、刘濛、隋虎林、马青波、郑春华、经纬、王海润。

1 范围

GB 26875的本部分规定了城市消防远程监控系统监控中心对外数据交换协议的缩略语、XML Schema定义、一般要求、数据查询接口和数据实时发布接口。
本部分适用于城市消防远程监控系统监控中心与外部系统之间的数据交换。

2 规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。
    GB 18030 信息技术中文编码字符集
    GB/T 26875.4-2011 城市消防远程监控系统第4部分：基本数据项
    GB 50440 城市消防远程监控系统技术规范
    RFC 2616 超文本传输协议(Hypertext Transfer Protocol-HTTP/1.1)
    RFC 2818 超文本传输安全协议(HTTP Over TLS)
    RFC 3023 XML媒体类型(XML Media Types)
    RFC 3629 ISO 10646的转换格式(UTF-8，a transformation format of ISO 10646)
    RFC 6749 OAuth 2.0认证框架(The OAuth 2.0 Authorization Framework)

3 术语和定义

GB 50440界定的术语和定义适用于本文件。

4 缩略语

下列缩略语适用于本文件。
    HTTP：超文本传输协议(Hypertext Transfer Protocol)
    HTTPS：超文本传输安全协议(HTTP Over TLS)
    REST：表述性状态转移(Representational State Transfer)
    URI：统一资源标识符(Uniform Resource Identifier)
    XML：可扩展标记语言(eXtensible Markup Language)
    XML Schema：可扩展标记语言架构定义(XML Schema Definition)

5 XML Schema定义

5.1 GB/T 26875.4-2011中规定的各类信息的XML Schema定义见附录A。
5.2 数据订阅请求、取消数据订阅请求、数据订阅响应及相关数据通知的XML Schema定义见附录B。
5.3 附录A、附录B所述XML Schema中引用的公用数据类型的XML Schema定义见附录C。

6 一般要求

6.1 本协议使用的字符集应满足GB 18030或RFC 3629的规定。
6.2 本协议应以HTTP或HTTPS协议作为底层承载协议。采用HTTP协议时，应满足RFC 2616的规定；采用HTTPS协议时，应满足RFC 2818的规定。
6.3 本协议宜采用OAuth 2.0协议进行客户端验证和授权，并满足RFC 6749的规定。
6.4 监控中心如未能处理接收到的请求时，返回的HTTP响应的状态代码(Status Code)应是400，实体主体(Entity Body)应是RFC 3023中描述的媒体类型为“application/xml”的错误响应。错误响应的XML Schema定义见A.15，其中description元素为错误描述；code元素为错误代码，取值范围为1～9999，仅1000～9999用于自定义错误，错误代码的定义见表1。

7 数据查询接口

7.1 数据查询请求
7.2 数据查询响应
7.3 数据查询细则

7.1 数据查询请求

7.1.1 任何查询请求应支持表2规定的通用查询参数。

7.1.2 查询请求接口应支持HTTP的GET方法。
注：GET方法是HTTP规定的客户端与服务器的交互方法之一，一般用于获取或查询资源信息。
7.1.3 查询请求接口应采用REST风格的HTTP接口，接口URL基本格式为http(s)：//…/openapi/vl/query/{uri}{query_string}，其中{uri}应支持7.3规定的各类查询的{uri}路径，{uri}可在任何“/”处截止，不以“/”结尾；{query_string}由通用查询参数和具体查询参数组合而成，在格式上，以“?”字符为起点，每个参数以“&”隔开，再以“＝”分开参数名称与参数值，同一参数的参数值如有多个，则以“，”连接参数值。如?key1＝value&key2＝value21，value22&…。

7.2 数据查询响应

7.2.1 查询响应数据的格式由查询请求的format参数指定。
7.2.2 查询响应数据的编码类型由查询请求的oe参数指定。

7.3 数据查询细则

7.3.1 监控中心查询
7.3.1.1 {uri}为jkzx_list/{jkzx_guid}。
7.3.1.2 {query_string}可使用表3规定的具体查询参数。

7.3.1.3 响应数据的XML Schema定义见A.1。
7.3.2 监控人员查询
7.3.2.1 {uri}为jkzx_list/{jkzx_guid}/jkry_list/{jkry_guid}。
7.3.2.2 {query_string}除可以使用7.3.1.2规定的参数外，还可使用表4规定的具体查询参数。

7.3.2.3 响应数据的XML Schema定义见A.2。
7.3.3 联网用户基本情况查询
7.3.3.1 {uri}为jkzx_list/{jkzx_guid}/lwyh_list/{lwyh_guid}。
7.3.3.2 {query_string}除可以使用7.3.1.2规定的参数外，还可使用表5规定的具体查询参数。

7.3.3.3 响应数据的XML Schema定义见A.3。
7.3.4 建、构筑物基本情况查询
7.3.4.1 {uri}为jkzx_list/{jkzx_guid}/lwyh_list/{lwyh_guid}/jgzw_list/{jgzw_guid}。
7.3.4.2 {query_string}除可以使用7.3.1.2、7.3.3.2规定的参数外，还可使用表6规定的具体查询参数。

7.3.4.3 响应数据的XML Schema定义见A.4。
7.3.5 消防安全重点部位基本情况查询
7.3.5.1 {uri}为jkzx_list/{jkzx_guid}/lwyh_list/{lwyh_guid}/xfaqzdbw_list/{xfaqzdbw_guid}。
7.3.5.2 {query_string}除可以使用7.3.1.2、7.3.3.2规定的参数外，还可使用表7规定的具体查询参数。

7.3.5.3 响应数据的XML Schema定义见A.5。
7.3.6 消防设施查询
7.3.6.1 {uri}为jkzx_list/{jkzx_guid}/lwyh_list/{lwyh_guid}/xfss_list/{xfss_guid}。
7.3.6.2 {query_string}除可以使用7.3.1.2、7.3.3.2规定的参数外，还可使用表8规定的具体查询参数。

7.3.6.3 响应数据的XML Schema定义见A.6。
7.3.7 消防设施部件查询
7.3.7.1 {uri}为jkzx_list/{jkzx_guid}/lwyh_list/{lwyh_guid}/xfss_list/{xfss_guid}/xfssbj_list/{xf-ssbj_guid}。
7.3.7.2 {query_string}除可以使用7.3.1.2、7.3.3.2、7.3.6.2规定的参数外，还可使用表9规定的具体查询参数。

7.3.7.3 响应数据的XML Schema定义见A.7。
7.3.8 受理查询
7.3.8.1 {uri}为jkzx_list/{jkzx_guid}/sl_list/{sl_guid}jkzx_list/{jkzx_guid}/lwyh_list/{lwyh_guid}/sl_list/{sl_guid}。
7.3.8.2 {query_string}除可以使用7.3.1.2、7.3.3.2规定的参数外，还可使用表10规定的具体查询参数。

7.3.8.3 响应数据的XML Schema定义见A.8。
7.3.9 查岗查询
7.3.9.1 {uri}为jkzx_list/{jkzx_guid}/cg_list/{cg_guid}或jkzx_list/{jkzx_guid}/lwyh_list/{lwyh_guid}/cg_list/{cg_guid}。
7.3.9.2 {query_string}除可以使用7.3.1.2、7.3.3.2规定的参数外，还可使用表11规定的具体查询参数。

7.3.9.3 响应数据的XML Schema定义见A.9。
7.3.10 火灾查询
7.3.10.1 {uri}为jkzx_list/{jkzx_guid}/hz_list/{hz_guid}或jkzx_list/{jkzx_guid}/lwyh_list/{lwyh_guid}/hz_list/{hz_guid}。
7.3.10.2 {query_string}除可以使用7.3.1.2、7.3.3.2规定的参数外，还可使用表12规定的具体查询参数。

7.3.10.3 响应数据的XML Schema定义见A.10。
7.3.11 消防设施检查查询
7.3.11.1 {uri}为jkzx_list/{jkzx_guid}/lwyh_list/{lwyh_guid}/xfssjc_list/{xfssjc_guid}。
7.3.11.2 {query_string}除可以使用7.3.1.2、7.3.3.2规定的参数外，还可使用表13规定的具体查询参数。

7.3.11.3 响应数据的XML Schema定义见A.11。
7.3.12 消防设施维护保养查询
7.3.12.1 {uri}为jkzx_list/{jkzx_guid}/lwyh_list/{lwyh_guid)/xfsswhby_list/{xfsswhby_guid}。
7.3.12.2 {query_string}除可以使用7.3.1.2、7.3.3.2规定的参数外，还可使用表14规定的具体查询参数。

7.3.12.3 响应数据的XML Schema定义见A.12。
7.3.13 消防法规查询
7.3.13.1 {uri}为xffg_list/{xffg_guid}。
7.3.13.2 响应数据的XML Schema定义见A.13。
7.3.14 消防常识查询
7.3.14.1 {uri}为xfcs_list/{xfcs_guid}。
7.3.14.2 响应数据的XML Schema定义见A.14。

8 数据实时发布接口

8.1 数据订阅请求
8.1.1 订阅请求接口应支持HTTP接口的POST方法。
注：POST方法是HTTP规定的客户端与服务器的交互方法之一，一般用于更新资源信息。
8.1.2 订阅请求接口应采用REST风格的HTTP接口，接口URL基本格式为http(s)：//…/openapi/vl/realtime/{uri}，其中{uri}应支持8.4规定的各类订阅地址的{uri}路径，{uri}可在任何“/”处截止，不以“/”结尾。
8.1.3 订阅请求的XML元素见表15，XML Schema定义见B.1。

8.1.4 取消订阅请求的XML元素见表16，XML Schema定义见B.2。

8.1.5 取消所有订阅请求的XML元素见表17，XML Schema定义见B.3。

8.2 数据订阅响应
8.2.1 订阅响应数据的格式由订阅请求的format参数指定。
8.2.2 订阅响应数据的编码类型由订阅请求的oe参数指定。
8.2.3 订阅响应数据的XML元素见表18，XML Schema定义见B.4。

8.3 数据发布通知回调
通知的接收方应在callback_url指定的地址，采用基于HTTP的Web Service接口等待接收监控中心的实时数据发布通知。
8.4 订阅请求和通知细则
消防设施部件状态变化通知的要求如下：
——URI路径为jkzx_list/{jkzx_guid}或jkzx_list/{jkzx_guid}/lwyh_list/{lwyh_guid}；
——过滤条件参数见表19；
——通知数据的XML Schema定义见B.5。