酒店-筛选项信息
基本信息
Path: /hotel/filter
Method: POST
使用说明
- 本接口用于获取与目的地或关键字关联的筛选项信息,比如选择目的地北京后,可以通过本接口获取北京拥有的酒店的品牌、设施、主题等,使用对应的筛选项传入hotel.list接口相关字段,可以获取到符合筛选条件的产品,一般是传入hotel,.list接口的QueryText字段。
- 本接口适于和hotel.list接口结合使用,获取的关键字信息中的关键字名称(Name字段)可以作为hotel.list接口的QueryText参数。
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | ||
| x-lvcang-api-account | 开放平台分配 | 是 | aaa.test |
Body
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| cityId | string | 必须 | 城市ID,可以从hotel.destination接口或者GEO静态数据中获取。 |
| hotFilter | boolean | 必须 | true-获取热门筛选项 false-获取所有筛选项 默认“false” |
| filterType | string | 非必须 | 指定获取那种类型的筛选项,多个类型时使用逗号隔开。 3-品牌 4-行政区 5-商圈 6-POI(大学、风景区、汽车站、火车站、地铁等) 1007-支付类型 1008-星级 1011-设施 1012-主题 1016-酒店特色 1020-评分 |
返回数据
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| code | number | 必须 | 返回码 0:请求成功 3000:请求失败 5000:请求异常 |
| message | string | 必须 | 请求消息 |
| success | boolean | 必须 | 请求是否成功 |
| data | object | 必须 | |
| ├─ hotelFilterInfos | object [] | 必须 | 筛选项结果列表 |
| ├─ typeId | integer | 必须 | 筛选项类型 3-品牌 4-行政区 5-商圈 6-POI(大学、风景区、汽车站、火车站等) 1007-支付类型 1008-星级 1010-房间可容纳人数 1011-设施 1012-主题 1016-酒店特色 1020-评分 1888-热门搜索 1889-热门酒店 |
| ├─ nameCn | string | 必须 | 筛选项中文名 |
| ├─ introduce | string | 非必须 | 简介 |
| ├─ hasSubNode | boolean | 必须 | 是否含有子节点 表示本筛选项是否还有子筛选项,例如选择了故宫,还可以向下级选择北海公园、天安门等 |
| ├─ subHotelFilterInfos | object [] | 非必须 | 递归子节点 hasSubNode为true时有值,表示本筛选项包含的子筛选项列表,节点类型与本节点一样 |
| ├─ parentTypeName | string | 非必须 | 父类型中文名称 |
| ├─ id | string | 必须 | 本筛选项的唯一标识 仅用于标识本筛选项 |
| ├─ idV4 | string | 非必须 | 筛选项V4ID 当TypeId为4时有值,可用于hotel.list接口DistrictId入参 |
| guid | string | 必须 | guid |
