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

ICS35.100

L79

国；

中华人民共和国国家标准

GB/T36555.1-2018

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

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

转移（REST）技术接口

Interfacespecificationforapplicationsystemofsmartresiding一

Part1:InterfacebasedonREST

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

国家市场监督管理总局峪非

中国国家标准化管理委员会0(..'I(J

GB/T36555.1-2018

目次

前言………………………..…….......U1

1范围－

2规范性引用文件－

3术语和定义·

4缩略i吾……………………1

5基本要求…………

6接口描述…………………2

附录A（资料性附录）REST和HTTP响应状态码……………………8

附录B（规范性附录）智慧安居应用系统资源URI…………………10

附录c（资料性附录）智慧安居应用系统资源参数…………….11

附录D（资料性附录）RTSP协议接口说明……………四

参考文献……...………·20

I

GB/T36555.1-2018

附录A

（资料性附录）

REST和HTTP晌应状态码

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

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

HTTP状态码REST含义POSTGETPUTDEL

成功COK）－－请求已经成功。

200头古II(Header）说明：无。××

消息休(Body）说明：在消息体巾返问所谓求的资源

创建成功（Created）－一请求已经创建了一项新的资源。

头部（Header）说明：Location头部字段包含了新创建资源

201的URIo×

消息休(Body）说明：响应消息体返问一个拙述新创建资源

的实体

无内容（NoContent）－一请求已经成功，但没有返问数据。

204头百~l(Header）说明：无。××

消息休(Body）说明：不允许有消息体

被；］＜.久移动（MovedPermanently）→一所请求资源位置己

被；j（久移动。

301头，宫和（Header）说明：Location头部字段包含资源新位置×

的URL

消息休CBody）说明：消息体可以包fr,资源的新位置

找到（Found）－所请求资源应该通过该位置访问，但实

际上该资源位于另一个位青。这是设置别名的典型用法。

302×

头百~l(Header）说明：Location头部字段包含资源的URlo

消息休(Body）说明·消息体可以包fr,资源的新位置

坏请求(BadRequest）－一请求消息构建不对，这通常用于

创建或更新一个资源时，其数据是不完整或不正确的。

头部（Header）说明：通过HTTP状态头部发送的原因说明

400×××

(Reason-Phrase）包含错误信息。

消息休(Body）说明：响应消息体可以包含更多的除头部

“原因说明”以外的隐含错误信息

未授权的（Unauthorized）→←请求；2日’要用户认证后才’能访

归Ji亥资源。如果请求包含无效认irE数据，则发送该H向应

消息。

头部（Header）说明·在WWW－八uthenticate头部字段巾应

401××××

指定至少一种认址机制。通过HTTP状态头部发送的原

因说明（Reason-Phrase）可包含错误信息。

消息休(Body）说明：H向应消息休可以包含更多的除头部

“原因说明”以外的隐含错误信息

8

GB/T36555.1-2018

表A.1（续）

HTTP状态码REST含义POSTGETPUTDEL

禁止（Forbidden）－一该请求是不允许的，因为服务苦苦拒绝

处现该请求。:Ii现这种情况的通常原因是设备不支持所

请求的功能。

403头·i\fl(Header）说明：通过HTTP状态头部发送的原因说明××××

(ReasonPhrase）可包含错误信息。

消息体（Body）说明：H向应消息、体可以包含更多的除头部

“原因说明”以外的隐含错误信息

找不flj(NotFound）→一所请求的资源不存在。

404头部（Header）说明：元。××××

消息体(Body）说明：无

方法不允许（MethodNotAllowed）－一请求所采用的

日TTP方法对该资源不支持，因为｛八PI协议）规范不允许

法。如果设备不支持该功能，但是有效的｛八PI协议｝

该方

405操作，则应返问403II向应码。××××

头部（Header）说明：八llow头部字段列川i针对该资源所支

持的HTTP方法。

消息、体(Body）说明：无

冲突（Conflict）一一所执行的操作与内部状态或正在执行

的过程冲突。这是一种过渡状态，延后一定时间可以重试

409该操作。×××

头部（Header）说明：元。

消息体(Body）说明：无

内部服务器错误(InternalServerError）－一发生了内部服

务器错误。

500××××

头部（Header）说明：无。

消息、体(Body）说明：无

服务不可用（ServiceUnavailable)--HTTP服务器是正

常的，但REST服务不可用。这通常是因为客户请求太多

引起的。

503××××

头有1l(Header）说明：Retry-After头部字段建议客户什么时

问再尝试重新发送请求。

消息、体(Body）说明：无

注．

“×”表示适用。

9

GB/T36555.1-2018

附录B

（规范性附录）

智慧安居应用系统资源URI

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

表B.1应用系统资源、URI

资源URI说明

序号

lASSR／八ffairslnfo政务信息资源

2ASSR/WeatberInfo天气信息资源

。"ASSR/Emergencylnfo紧急信息资源

4ASSR/Travellnfoii＼行信息资源

5ASSR/ActivityInfo活动信息资源

6ASSR/Housekeepinglnfo家政信息资源

7ASSR/EbusinessInfo电子商务信息资源

8ASSR/MedicalServerInfo

医疗服务信息资源

9ASSR／八larmlnfo

报警求助信息资源

10ASSR/VideoInfo视lyjij监控罔像资源

11ASSR/PersonneIAccess

人员川1人信息资源

12ASSR/VebicleAccess车辆；I＼人信息资源

13八SSR/ParkingManagement

年位管理信息资源

14八SSR/Subscribelnfo

订阅服务信息资源

15八SSR/Helplnfo

iLf程求助信息资源

16八SSR/Positionlnfo定位跟踪信息资源

17八SSR/Customizelnfo个性定iltLl信息资源

10

GB/T36555.1-2018

附录C

（资料性附录）

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

C.1政务信息

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

表C.1政务信息参数

序号名称标识符类型

必选备注

数据类型

lIDGB/T36554-2018

政务信息标识符是

(string)

2PublishDeptstring

政务信息发布单位乎乎

时间类型

3PublishTime格式：YYYYMMDDbhmmss

政务信息发布时间是

CdateTime)

4政务信息标题Titlestring是

5政务信息类型Categorystring平T

6政务信息内容Contentstring手T

C.2天气信息

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

表C.2天气信息参数

类型

序号名称标识符必选备注

l天气标i:H符IDstring是GB!T365542018

2天气顶报城市Citystring是

时间类型

3天气预报日期ForcastDate是格式：YYYYMMDD

(date)

4气象和｜’类Typestring是

数据类型

5当前气？原CurrentTemperature是单位：摄氏度

(int)

6本日最低气泪MaxTemperaturemt子T单位：摄氏度

7本日最高气泪MinTemperaturemt有

单位：摄氏度

C.3紧急信息

紧急信息的参数参见表C.30

11

GB/T36555.1-2018

表C.3紧急信息参数

类型

序号名称标识符必选备注

l紧急信息标识彷：IDstring是GB/T365542018

2紧急信息发布单位PublishDeptstnng1i

3PublisbTimedateTime格式：YYYYMMDDhhmmss

紧急信息发布时间是

4紧急信息标题Titlestring是

5紧急信息类型Categorystring1-i'

6紧急信息内容Contentstnng1i

7Levelint是

紧急信息级别

C.4出行信息

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

表C.4出行信息参数

名称标i,,H符类型

序号必选备注

II＼行信息标识符IDstring是GB/T365542018

2II＼行信息标题Titlestnng是

3II＼行信息内容Contentstring1i

4II＼行信息开始时间BeginTimedateTime是格式：YYYYMMDDhhmmss

5II＼行信息结束时问EndTimedateTime是格式：YYYYMMDDbhmmss

6/1＼发点StartingPointstnng是

目的地Destinationstring是

8公交站点BusStopstnng1i

9公交线路BusLinestnng乎？

10拥培时间CongestionTimeint4马单位．分钟

11拥培程度CongestionLevelint乎乎

C.5活动信息

活动信息的参数参见表C.50

表C.