中华人民共和国国家标准
GB/T 26875.8-2015
Remote-monitoring system of urban fire protection-Part 8:External data exchange protocol for monitoring center
中国国家标准化管理委员会 中华人民共和国国家质量监督检验检疫总局 发布
目 次
前言1范围3术语和定义 2规范性引用文件4缩略语5XML Sehema 定义一般要求7数据查询接口8数据实时发布接口附录A(规范性附录) 数据查询接口相关的XMLSchema定义 10附录B(规范性附录)数据实时发布接口相关的XMLSchema定义 18附录C(规范性附录)公用数据类型的XMLSchema定义
前言
GB26875《城市消防远程监控系统》分为以下八个部分:
第1部分:用户信息传输装置; 第2部分:通信服务器软件功能要求;第3部分:报警传输网络通信协议:第4部分:基本数据项;一第6部分:信息管理软件功能要求: 一第5部分:受理软件功能要求;一第7部分:消防设施维护管理软件功能要求:一第8部分:监控中心对外数据交换协议.
本部分为GB26875的第8部分.
本部分按照GB/T1.1-2009给出的规则起草.
本部分由中华人民共和国公安部提出.
本部分由全国消防标准化技术委员会(SAC/TC113)归口.
本部分负责起草单位:公安部沈阳消防研究所.
本部分参加起草单位:深圳市赋安安全系统有限公司、万盛(中国)科技有限公司、海湾安全技术有限公司.
本部分主要起草人:李志刚、王军、张迪、杨树峰、刘海霞、裴建国、齐宝金、全瑞涛、赵海荣、张磊、杜阳、乔培玉、刘、隋虎林、马青波、郑春华、经纬、王海润.
第8部分:监控中心对外数据交换协议 城市消防远程监控系统
1范围
GB26875的本部分规定了城市消防远程监控系统监控中心对外数据交换协议的缩略语、XMLSchema定义、一般要求、数据查询接口和数据实时发布接口.
本部分适用于城市消防远程监控系统监控中心与外部系统之间的数据交换,
2规范性引用文件
下列文件对于本文件的应用是必不可少的.凡是注日期的引用文件,仅注日期的版本适用于本文件.凡是不注日期的引用文件,其最新版本(包括的修改单)适用于本文件.
GB18030信息技术中文编码字符集 GB/T26875.4-2011城市消防远程监控系统第4部分:基本数据项GB50440城市消防远程监控系统技术规范RFC 2616超文本传输协议(Hypertext Transfer ProtocolHTTP/1.1)RFC 2818超文本传输安全协议(HTTPOverTLS)RFC 3023XML媒体类型(XML Media Types) RFC 3629 ISO 10646 的转换格式(UTF-8 a transformation format of ISO 10646)RFC 6749OAuth 2.0 认证框架(The OAuth 2.0 Authorization Framework)
3术语和定义
GB50440界定的术语和定义适用于本文件.
4缩略语
下列缩略语适用于本文件,
HTTP:超文本传输协议(Hypertext Transfer Protocol)HTTPS:超文本传输安全协议(HTTPOverTLS)REST:表述性状态转移(Representational State Transfer)UR1:统-资源标识符(Uniform Resource Identifier) XML,可扩展标记语言(eXtensible Markup Language)XMLSchema:可扩展标记语言架构定义(XML Schema Definition)
5XML Schema定义
5.1GB/T26875.4-2011中规定的各类信息的XMLSchema定义见附录A.5.2数据订阅请求、取消数据订阅请求、数据订阅响应及相关数据通知的XML.Schema定义见附录B.
5.3附录A、附录B所述XMLSchema中引用的公用数据类型的XMLSchema定义见附录C.
6一般要求
6.1本协议使用的字符集应满足GB18030或RFC3629的规定.6.2本协议应以HTTP或HTTPS协议作为底层承载协议.采用HTTP协议时,应满足RFC2616的规定;采用HTTPS协议时,应满足RFC2818的规定.6.3本协议宜采用OAuth2.0协议进行客户端验证和授权,并满足RFC6749的规定.6.4监控中心如未能处理接收到的请求时,返回的HTTP响应的状态代码(StatusCode)应是400,实 体主体(Entity Body)应是RFC3023中描述的媒体类型为”application/xml"的错误响应.错误响应的XML.Schema定义见A.15,其中description元素为错误描述;code元素为错误代码,取值范围为1~9999,仅1000~9999用于自定义错误,错误代码的定义见表1.
表1错误代码表
错误代码 错误含义1 2 监控中心暂时停止数据交换服务 未知错误3 监控中心不支持的数据交换请求4 客户应用的身份无法确定5 客户应用被禁用客户应用的IP被禁止7 客户应用的请求额率超过限制8 客户应用的权限不足9 请求参数无效10 请水无法被处理 请求参数缺失100 11 监控中心不存在指定的数据200 订阅请求无法添加201 取消订阅时sabscribe_id不存在6666~000[ 自定义
7数据查询接口
7.1数据查询请求
7.1.1任何查询请求应支持表2规定的通用查询参数.