GB/T 36555.1-2018 智慧安居应用系统接口规范 第1部分：基于表述性状态转移(REST)技术接口

　　ICS 35 . 100 L 79

　　中 华 人 民 共 和 国 国 家 标 准

　　GB/T 36555. 1—2018

　　智慧安居应用系统接口规范

　　第 1 部分：基于表述性状态

　　转移(REST)技术接口

　　Interfacespecificationforapplicationsystem ofsmartresiding—

　　part1：Interfacebasedon REST

　　2018-07-13 发布 2018-1 1-01 实施

　　国家市场监督管理总局中国国家标准化管理委员会

　　发

　　布

　　GB/T 36555 . 1—2018

　　GB/T 36555 . 1—2018

　　前 言

　　GB/T 36555《智慧安居应用系统接口规范》预计分为以下部分：

　　— 第 1 部分：基于表述性状态转移(REST)技术接口;

　　— 第 2 部分：基于 SOAP WEBService技术接口;

　　— 第 3 部分：基于软件开发工具包 SDK 接 口 。

　　本部分为 GB/T 36555 的第 1 部分。

　　本部分按照 GB/T 1 . 1—2009 给出的规则起草。

　　请注意本文件的某些内容可能涉及专利。 本文件的发布机构不承担识别这些专利的责任。

　　本部分由全国电子业务标准化技术委员会(SAC/TC 83)提出并归口 。

　　本部分起草单位：浙江省标准化研究院、浙江大华技术股份有限公司、浙江航天长峰科技发展有限公司、杭州鸿雁电器有限公司、杭州汤米智能科技有限公司、厦门市标准化研究院、浙江省邮电工程建设有限公司、中国标准化研究院、杭州天策启瑞科技有限公司、杭州聪普智能科技有限公司、浙江好络维医疗技术有限公司、惠州市质量技术监督标准与编码所、绍兴瑞谷物联网技术有限公司、浙江科技学院、东莞市新支点科技服务有限公司。

　　本部分主要起草人：李宁、丁凯、孔维生、焦庆春、毛卫琪、宋丽红、徐超龙、林立南、李俊毅、冯文斌、刘璇、任冠华、赵强、徐丽丽、应致标、温志凡、朱彬、杜能、周广平、李毅。

　　GB/T 36555 . 1—2018

　　智慧安居应用系统接口规范第 1 部分：基于表述性状态

　　转移(REST)技术接口

　　1 范围

　　GB/T 36555 的本 部 分 规 定 了 智 慧 安 居 应 用 系 统(以 下 简 称 应 用 系 统)基 于 表 述 性 状 态 转 移(REST)技术接口的术语和定义、缩略语、基本要求、接口描述。

　　本部分适用于智慧安居应用系统的设计、开发、运行使用和维护管理。

　　2 规范性引用文件

　　下列文件对于本文件的应用是必不可少的。 凡是注 日期的引用文件，仅注 日期的版本适用于本文件 。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。

　　GB/T 36553—2018 智慧安居应用系统基本功能要求

　　3 术语和定义

　　下列术语和定义适用于本文件。

　　3.1

　　智慧安居应用系统 applicationsystem ofsmartresiding

　　基于信息技术实现数据分析和响应处理，满足服务区域内居民安全与舒适的生活需求，并提供交互式信息服务的应用系统。

　　4 缩略语

　　下列缩略语适用于本文件。

　　ASSR：智慧安居应用系统(Application System of Smart Residing)

　　HTTP：超文本传输协议(HyperText Transfer Protocol)

　　HTTPS：安全的超文本传输协议(HyperText Transfer Protocol over Secure Socket Layer)

　　IP：因特网协议(Internet Protocol)

　　JSON:JavaScript对象标记语言(JavaScript Object Notation)

　　PS：节目流(Program Stream)

　　REST：表述性状态转移(Representational State Transfer)

　　RTP：实时传输协议(Real-time Transport Protocol)

　　URI：全局资源标识符(Universal Resource Identifier)

　　5 基本要求

　　接口协议结构应采用 REST架构进行定义，REST 服务通过 HTTP 的方法动词[向指定的资源提

　　GB/T 36555 . 1—2018

　　交要被处理的数据(post)、上传指定的 URI 表示(put)、从指定的资源请求数据(get)、删除指定资源(delete)]实现，消息体采用 JSON进行封装。

　　HTTP URI格式定义为：〈Protocol〉：//〈IP〉：〈Port〉/〈URI〉?p1=v1&p2 = v2 & … &pn= vn。其中，Protocol应支持 HTTP,宜支持 HTTPS。IP 为主机地址或域名，Port 为 HTTP 请求所用的端 口号，URI 为指资源 URI,(? p1=v1&p2=v2&… &pn=vn)为指查询字符串，每个资源都会定义相关的

　　查询字符串参数，查询字符串参数以键/值对形式出现。

　　注：接口消息头域 Content-Type 为 application/ASSR+JSON。REST 和 HTTP 响应状态码参见附录 A。

　　6 接口描述

　　6 . 1 概述

　　智慧安居应用系统由基础资源数据、信息服务应用和综合服务平台构成，其中信息服务基本应用由公共信息、居家生活、保障服务和定制服务等功能模块组成，具体功能要求应符合 GB/T 36553—2018规定。

　　接口适用于综合服务平台通过接口从应用系统获取信息。

　　接口消息描述包括描述资源 URI、功能(描述功能行为)、方法(列出资源的 HTTP 操作方法)和注释(接口消息的描述说明)，其中方法包括查询字符串(描述资源的键/值对)、消息体(描述 HTTP 请求的消息体)和返回结果(描述 HTTP请求的响应)。

　　应用系统资源 URI说明见附录 B,接口消息描述格式见表 1 。

　　表 1 接口消息描述格式

　　6 . 2 公共信息服务接口

　　6 . 2 . 1 政务信息接口

　　综合服务平台从应用系统获取政务信息，政务信息查询接口消息描述见表 2 。

　　表 2 政务信息查询消息

　　GB/T 36555 . 1—2018

　　6 . 2 . 2 天气信息接口

　　综合服务平台从应用系统获取天气信息，天气信息查询接口消息描述见表 3 。

　　表 3 天气信息查询消息

　　6 . 2 . 3 紧急信息接口

　　综合服务平台从应用系统获取紧急信息，紧急信息查询接口消息描述见表 4 。

　　表 4 紧急信息查询消息

　　6 . 3 居家生活服务接口

　　6 . 3 . 1 出行信息接口

　　综合服务平台从应用系统获取出行信息，出行信息查询接口消息描述见表 5 。

　　表 5 出行信息查询消息

　　6 . 3 . 2 活动信息接口

　　综合服务平台从应用系统获取活动信息，活动信息查询接口消息描述见表 6 。

　　GB/T 36555 . 1—2018

　　表 6 活动信息查询消息

　　6 . 3 . 3 家政信息接口

　　综合服务平台从应用系统获取家政信息，家政信息查询接口消息描述见表 7 。

　　表 7 家政信息查询消息

　　6 . 3 . 4 电子商务信息接口

　　综合服务平台从应用系统获取电子商务信息，电子商务信息查询接口消息描述见表 8 。

　　表 8 电子商务信息查询消息

　　6 . 3 . 5 医疗服务信息接口

　　综合服务平台从应用系统获取医疗服务信息，医疗服务信息查询接口消息描述见表 9 。

　　表 9 医疗服务信息查询消息

　　GB/T 36555 . 1—2018

　　6 . 4 保障服务接口

　　6 . 4 . 1 报警求助信息接口

　　综合服务平台通过应用系统上传报警求助信息，报警求助信息增加接口消息描述见表 10 。

　　表 10 报警求助信息增加消息

　　6 . 4 . 2 视频监控图像接口

　　综合服务平台从应用系统获取视频监控图像，视频监控图像查询接口消息描述见表 11 。

　　表 1 1 视频监控图像查询消息

　　6 . 4 . 3 人员出入信息接口

　　综合服务平台从应用系统获取人员出入信息，人员出入信息查询接口消息描述见表 12 。

　　表 12 人员出入信息查询消息

　　6 . 4 . 4 车辆出入信息接口

　　综合服务平台从应用系统获取车辆出入信息，车辆出入信息查询接口消息见表 13 。

　　GB/T 36555 . 1—2018

　　表 13 车辆出入信息查询消息

　　6 . 4 . 5 车位管理信息接口

　　综合服务平台从应用系统获取车位管理信息，车位管理信息查询接口消息描述见表 14 。

　　表 14 车位管理信息查询消息

　　6 . 5 定制服务接口

　　6 . 5 . 1 订阅服务信息接口

　　综合服务平台向应用系统订阅服务信息，订阅服务信息增加接口消息描述见表 15 。

　　表 15 订阅服务信息增加消息

　　6 . 5 . 2 远程求助信息接口

　　综合服务平台向应用系统上传远程求助信息，远程求助信息增加接口消息描述见表 16 。

　　表 16 远程求助信息增加消息

　　GB/T 36555 . 1—2018

　　6 . 5 . 3 定位跟踪信息接口

　　综合服务平台向应用系统获取定位跟踪信息，定位跟踪信息查询接口消息描述见表 17 。

　　表 17 定位跟踪信息查询消息

　　6 . 5 . 4 个性定制信息接口

　　综合服务平台向应用系统上传个性定制信息，个性定制信息增加接口消息描述见表 18 。

　　表 18 个性定制信息增加消息

　　GB/T 36555 . 1—2018

　　附 录 A

　　(资料性附录)

　　REST和 HTTP响应状态码

　　REST 和 HTTP 响应状态码参见表 A. 1 。

　　表 A.1 REST和 HTTP响应状态码

　　GB/T 36555 . 1—2018

　　表 A.1(续)

　　GB/T 36555 . 1—2018

　　附 录 B

　　(规范性附录)

　　智慧安居应用系统资源 URI

　　智慧安居应用系统资源 URI参见表 B. 1 。

　　表 B.1 应用系统资源 URI

　　GB/T 36555 . 1—2018

　　附 录 C

　　(资料性附录)

　　智慧安居应用系统资源参数

　　C.1 政务信息

　　政务信息的参数参见表 C. 1 。

　　表 C.1 政务信息参数

　　C.2 天气信息

　　天气信息的参数参见表 C. 2 。

　　表 C.2 天气信息参数

　　C.3 紧急信息

　　紧急信息的参数参见表 C. 3 。

　　GB/T 36555 . 1—2018

　　表 C.3 紧急信息参数

　　C.4 出行信息

　　出行信息的参数参见表 C. 4 。

　　表 C.4 出行信息参数

　　C.5 活动信息

　　活动信息的参数参见表 C. 5 。

　　表 C.5 活动信息参数

　　GB/T 36555 . 1—2018

　　表 C.5(续)

　　C.6 家政信息

　　家政信息的参数参见表 C. 6 。

　　表 C.6 家政信息参数

　　C.7 电子商务信息

　　电子商务信息的参数参见表 C. 7 。

　　表 C.7 电子商务信息参数

　　GB/T 36555 . 1—2018

　　表 C.7(续)

　　C.8 医疗服务信息

　　医疗服务信息的参数参见表 C. 8 。

　　表 C.8 医疗服务信息参数

　　C.9 报警求助信息

　　报警求助信息的参数参见表 C. 9 。

　　GB/T 36555 . 1—2018

　　表 C.9 报警求助信息参数

　　C.10 视频监控信息

　　视频监控信息的参数参见表 C. 10 。

　　表 C.10 视频监控信息参数

　　C.1 1 人员出入信息

　　人员出入信息的参数参见表 C. 11 。

　　表 C.1 1 人员出入信息参数

　　GB/T 36555 . 1—2018

　　C.12 车辆出入信息

　　车辆出入信息的参数参见表 C. 12 。

　　表 C.12 车辆出入信息参数

　　C.13 车位管理信息

　　车位管理信息的参数参见表 C. 13 。

　　表 C.13 车位管理信息参数

　　C.14 订阅服务信息

　　订阅服务信息的参数参见表 C. 14 。

　　表 C.14 订阅服务信息参数

　　GB/T 36555 . 1—2018

　　C.15 远程求助信息

　　远程求助信息的参数参见表 C. 15 。

　　表 C.15 远程求助信息参数

　　C.16 定位跟踪信息

　　定位跟踪信息的参数参见表 C. 16 。

　　表 C.16 定位跟踪信息参数

　　C.17 个性定制信息

　　个性定位信息的参数参见表 C. 17 。

　　表 C.17 个性定制信息参数

　　GB/T 36555 . 1—2018

　　C.18 应答状态信息

　　应答状态信息的参数参见表 C. 18 。

　　表 C.18 应答状态信息参数

　　GB/T 36555 . 1—2018

　　附 录 D

　　(资料性附录)

　　RTSP协议接口说明

　　D.1 RTSP协议接口 URL说明参见表 D. 1 。

　　表 D.1 RTSP URL说明

　　D.2 RTSP协议接口 RTP传输层说明参见表 D. 2 。

　　表 D.2 RTP传输层说明

　　GB/T 36555 . 1—2018

　　参 考 文 献

　　[1] GB/T 21062 . 3—2007 政务资源交换体系 第 3 部分：数据接口规范

　　[2] GB/T 28181—2016 公共安全视频监控联网系统信息传输、交换、控制技术要求

　　[3] GB/T 36554—2018 智慧安居信息服务资源分类与编码规则

　　[4] GB/T 36552—2018 智慧安居信息服务资源描述格式

　　[5] GA 329 . 2 全国道路交通管理信息数据库规范 第 2 部分：机动车登记信息数据结构