中华人民共和国国家标准
GB/T 36555.1-2018
智慧安居应用系统接口规范 第1部分：基于表述性状态 转移（REST）技术接口
Interface specification for application system of smart residingPart 1:Interface based on REST
中国国家标准化管理委员会 国家市场监督管理总局 发布
目次
前言1范2规范性引用文件3术语和定义4缩略语5基本要求6接口描述附录A（资料性附录） 附录B（规范性附录） REST和HTTP响应状态码 智慧安居应用系统资源UR1附录C（资料性附录） 智慧安居应用系统资源参数附录D（资料性附录） RTSP协议接口说明 6L 11参考文献...
前言
GB/T36555《智慧安居应用系统接口规范》预计分为以下部分：
第1部分：基于表述性状态转移（REST）技术接口；
第3部分：基于软件开发工具包SDK接口.
本部分为GB/T36555的第1部分.
本部分按照GB/T1.1-2009给出的规则起草.
请注意本文件的某些内容可能涉及专利.本文件的发布机构不承担识别这些专利的责任.
本部分由全国电子业务标准化技术委员会（SAC/TC83）提出并归口.
本部分起草单位：浙江省标准化研究院、浙江大华技术股份有限公司、浙江航天长峰科技发展有限公司、杭州鸿雁电器有限公司、杭州汤米智能科技有限公司、厦门市标准化研究院、浙江省邮电工程建设有限公司、中国标准化研究院、杭州天策启瑞科技有限公司、杭州聪普智能科技有限公司、浙江好络维医疗技术有限公司、惠州市质量技术监督标准与编码所、绍兴瑞谷物联网技术有限公司、浙江科技学院、东莞市新支点科技服务有限公司.
本部分主要起草人：李宁、丁凯、孔维生、焦庆春、毛卫琪、宋丽红、徐超龙、林立南、李俊毅、冯文斌、刘璇、任冠华、赵强、徐丽丽、应致标、温志凡、朱彬、杜能、周广平、李毅.
智慧安居应用系统接口规范 第1部分：基于表述性状态 转移（REST）技术接口
1范围
（REST）技术接口的术语和定义、缩略语、基本要求、接口描述. GB/T36555的本部分规定了智慧安居应用系统（以下简称应用系统）基于表述性状态转移
本部分适用于智慧安居应用系统的设计、开发、运行使用和维护管理.
2规范性引用文件
下列文件对于本文件的应用是必不可少的.凡是注日期的引用文件，仅注日期的版本适用于本文件，凡是不注日期的引用文件，其最新版本（包括的修改单）适用于本文件.
GB/T36553-2018智慧安居应用系统基本功能要求
3术语和定义
下列术语和定义适用于本文件.
3.1
智慧安居应用系统application systemof smart residing
基于信息技术实现数据分析和响应处理，满足服务区域内居民安全与舒适的生活需求，并提供交互式信息服务的应用系统.
4缩略语
下列缩略语适用于本文件.ASSR：智慧安居应用系统（ApplicationSystem 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）RTP：实时传输协议（Real-timeTransport Protocol) REST：表述性状态转移（Representational State Transfer)URI：全局资源标识符（UniversalResource Identifier）
5基本要求
接口协议结构应采用REST架构进行定义，REST服务通过HTTP的方法动词[向指定的资源提
交要被处理的数据（post）、上传指定的URI表示（put）、从指定的资源请求数据（get）、删除指定资源（delete）实现，消息体采用JSON进行封装.
HTTP URI格式定义为：//<IP）<Port）/(URI）？p1=v1&.p2=v2&&pn=vn.其中，Protocol应支持HTTP，宜支持HTTPS，IP为主机地址或域名，Port为HTTP请求所用的端口号，URI为指资源URI.（？pl=v1&p2=v2&.&pn=vn）为指查询字符申，每个资源都会定义相关的 查询字符申参数，查询字符申参数以键/值对形式出现. 注：接口消息头域 Content-Type 为 application/ASSRJSON.REST 和 HTTP 响应状态码参见附录 A. 6接口描述 6.1概述 智慧安居应用系统由基础资源数据、信息服务应用和综合服务平台构成，其中信息服务基本应用由公共信息、居家生活、保障服务和定制服务等功能模块组成，具体功能要求应符合GB/T36553一2018规定. 接口适用于综合服务平台通过接口从应用系统获取信息. 接口消息描述包括描述资源UR1、功能（描述功能行为）、方法（列出资源的HTTP操作方法）和注释（接口消息的描述说明），其中方法包括查询字符申（描述资源的键/值对）、消息体（描述HTTP请求的消息体）和返回结果（描述HTTP请求的响应）. 应用系统资源URI说明见附录B，接口消息描述格式见表1. 表1接口消息描述格式 UR1功能方法 查询字符串 消息体 返回结果GETPOST PUTDELETE注释 6.2公共信息服务接口 6.2.1政务信息接口 综合服务平台从应用系统获取政务信息，政务信息查询接口消息描述见表2. 表2政务信息查询消息 UR1 ASSR/Affairslnfo 查询政务信息功能 方法 查询字符申 消息体 返回结果GET AffairsInfo属性键/值对 N/A 注释 AffairsInfo 参见附录C中 C.1
