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