Skip to content

酒店-筛选项信息

基本信息

Path: /hotel/filter

Method: POST

使用说明

  • 本接口用于获取与目的地或关键字关联的筛选项信息,比如选择目的地北京后,可以通过本接口获取北京拥有的酒店的品牌、设施、主题等,使用对应的筛选项传入hotel.list接口相关字段,可以获取到符合筛选条件的产品,一般是传入hotel,.list接口的QueryText字段。
  • 本接口适于和hotel.list接口结合使用,获取的关键字信息中的关键字名称(Name字段)可以作为hotel.list接口的QueryText参数。

请求参数

Headers

参数名称参数值是否必须示例备注
Content-Typeapplication/json
x-lvcang-api-account开放平台分配aaa.test

Body

名称类型是否必须备注
cityIdstring必须城市ID,可以从hotel.destination接口或者GEO静态数据中获取。
hotFilterboolean必须true-获取热门筛选项 false-获取所有筛选项 默认“false”
filterTypestring非必须指定获取那种类型的筛选项,多个类型时使用逗号隔开。 3-品牌 4-行政区 5-商圈 6-POI(大学、风景区、汽车站、火车站、地铁等) 1007-支付类型 1008-星级 1011-设施 1012-主题 1016-酒店特色 1020-评分

返回数据

名称类型是否必须备注
codenumber必须返回码 0:请求成功 3000:请求失败 5000:请求异常
messagestring必须请求消息
successboolean必须请求是否成功
dataobject必须
├─ hotelFilterInfosobject []必须筛选项结果列表
├─ typeIdinteger必须筛选项类型 3-品牌 4-行政区 5-商圈 6-POI(大学、风景区、汽车站、火车站等) 1007-支付类型 1008-星级 1010-房间可容纳人数 1011-设施 1012-主题 1016-酒店特色 1020-评分 1888-热门搜索 1889-热门酒店
├─ nameCnstring必须筛选项中文名
├─ introducestring非必须简介
├─ hasSubNodeboolean必须是否含有子节点 表示本筛选项是否还有子筛选项,例如选择了故宫,还可以向下级选择北海公园、天安门等
├─ subHotelFilterInfosobject []非必须递归子节点 hasSubNode为true时有值,表示本筛选项包含的子筛选项列表,节点类型与本节点一样
├─ parentTypeNamestring非必须父类型中文名称
├─ idstring必须本筛选项的唯一标识 仅用于标识本筛选项
├─ idV4string非必须筛选项V4ID 当TypeId为4时有值,可用于hotel.list接口DistrictId入参
guidstring必须guid