酒店列表
获取已合作上线且开业的酒店列表
特殊场景说明#
酒店终止合作下线(含酒店停业等),此接口不会返回该酒店任何数据,因此,需要调用方将上次同步到的酒店清单与当前最新酒店清单做比较,将已经终止合作下线的酒店剔除下线。
请求方式#
GET
uri: /hotels
Content-Type:application/json
请求参数说明#
RequestHeader#
响应参数说明#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| code | Integer | Y | - | 响应码-code[引用] | |
| content | List<HotelsResponse> | N | - | 响应体内容 | |
| message | String | N | 500 | ||
| responseDes | String | N | 2000 | 错误信息详细描述, 日常排障使用 |
HotelsResponse#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| hotelId | String | Y | 32 | 12**567 | 华住酒店ID |
| hotelName | String | Y | 128 | 汉庭 | 酒店名称 |
响应码#
| 异常码 | 异常类型 | 说明 |
|---|---|---|
| 1000 | Success | |
| 3101 | No match found | 未找到与条件匹配的数据 |
| 3102 | The number of requests exceed the daily limit | 请求次数超过每日限制 |
| 其他 | 全局异常码 | 全局异常[引用] |
报文示例#
Case1: 查询酒店列表#
请求示例#
仅传header头中的参数公共请求头[引用]
响应成功示例#
{ "code":1000, "content":[ { "hotelId":"12**567", "hotelName":"汉庭*****酒店" }, { "hotelId":"12**567", "hotelName":"汉庭*****酒店" } ]}响应失败示例#
{ "code":3101, "message":"No match found"}