酒店-列表

基本信息

Path： /hotel/list

Method： POST

使用说明

1.酒店列表搜索,可搜索180天内的可卖酒店数据。日期的限定可以在日历上实现，同时在调用接口前验证。

2.搜索结果对应的库存已经做到每分钟更新。

3.支付方式：

• 预付：预付都是全额预付，也要考虑取消的情况。

请求参数

Headers

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

Body

名称	类型	是否必须	备注
arrivalDate	string	必须	入住日期 大于等于昨天。如果入住的时间为凌晨，那么传入前一天的日期。
departureDate	string	必须	离店日期 至少晚于到店时间1天，不多于30天
cityId	string	必须	城市编码 可以从GEO数据静态文件中获取，不可为空
queryText	string	非必须	查询关键词 全文检索，可以是酒店名、位置或品牌等。使用本参数的时候，需要输入CityId或DistrictId
queryType	string	非必须	查询类型 Intelligent 智能搜索 （默认） HotelName 酒店名称 LocationName 位置名称 默认“Intelligent”
paymentType	string	非必须	支付方式 All-全部（默认）、SelfPay-现付、Prepay-预付 默认“预付”
productProperties	string	非必须	产品类型 支持多个选项同时传入，以逗号分隔。本参数是筛选包含指定条件的酒店，结果中的酒店可能包含其他属性的产品请自行过滤。可选值为： All =全部, LastMinuteSale =今日特价, LimitedTimeSale =限时抢购, WithoutGuarantee =免担保 AdvanceBooking=早订优惠 LongStayBooking=连住优惠 默认“All”
starRate	string	非必须	推荐星级 对应酒店详情静态文件中的Category。搜索多个星级以逗号分隔 可选值：0,1,2：客栈；3：舒适；4：高档；5：豪华；A：公寓
brandId	string	非必须	品牌编码 可以从酒店品牌静态文件中获取
groupId	integer	非必须	酒店集团编码
lowRate	integer	非必须	最小价格 过滤的是酒店中的产品,如果酒店的产品有一个满足这个区间这个酒店就算满足这个条件。注意不是按酒店最低价格来过滤的。
highRate	integer	非必须	最大价格 过滤的是酒店中的产品,如果酒店的产品有一个满足这个区间这个酒店就算满足这个条件。注意不是按酒店最低价格来过滤的。
districtId	string	非必须	地区编码 可以从GEO数据静态文件中获取
businessZoneId	string	非必须	商圈编码 可以从GEO数据静态文件中获取
position	object	非必须	位置查询 点选位置搜索，坐标采用百度的坐标体系，字段参考Position节点 注意： 1.本字段不为空时，其中所有的属性（longitude、latitude、radius）都不能为空。2.本字段不为空时，搜索类型是周边搜索，返回的酒店经纬度会在指定半径范围，但如果传入了QueryText且这边解析为一个poi, 则按照poi类型搜索，不会按照周边搜索，所以可能返回的经纬度超出指定范围。 3.如果本字段为空，默认搜索类型为地区搜索，如果传入了QueryText，且这边解析为poi, 则按照poi类型搜索
├─ longitude	number	必须	经度 百度坐标系
├─ latitude	number	必须	维度 百度坐标系
├─ radius	integer	必须	半径 单位：米,最大20000m
invoiceMode	string	非必须	预付发票模式 Elong-平台开发票、Hotel-酒店开发票 不传该字段表示不限制发票类型 前台自付产品都是酒店开发票，这里的过滤是针对预付产品。 需要注意平台开发票其实是平台可以提供代开发票服务，如果需要开通，请联系商务
sort	string	非必须	排序类型 Default平台默认排序 StarRankDesc推荐星级降序 RateAsc价格升序 RateDesc价格降序 DistanceAsc距离升序 默认“Default”
pageIndex	integer	非必须	从1开始 默认“1”
pageSize	integer	非必须	取值范围：1-20 默认“10”
customerType	string	非必须	宾客类型 None=全部; （默认） All=统一价； Chinese =内宾价，需提示客人“须持大陆身份证入住”； OtherForeign =外宾价，需提示客人“须持国外护照入住”； HongKong =港澳台客人价，需提示客人“须持港澳台身份证入住”； ChinaGuest =中宾价，需提示客人“须持中国身份证、护照入住”； 搜索时传All表示搜索对所有宾客售价一致的产品，此时搜索结果中不包含Chinese、OtherForeigh等类型的产品。如果需要查询所有产品，那么传None。 默认“None”
checkInPersonAmount	integer	非必须	默认为0，结果返回的酒店中将包含至少一个房间的可容纳人数大于等于该值，小于该值的房型将会过滤掉
resultType	string	非必须	返回信息类型 可以是逗号分隔的组合。 1.可销售价格信息(房间、RP、促销、增值) 2. 规则信息(预订、Drr、担保规则、预付规则) 3. 酒店基本信息，即返回信息中的Detail字段 4. 当前不可销售的rp（产品计划）不出现在结果里 5. 不返回Rooms、GuaranteeeRules、PrepayRules、AddValues等和产品有关系的对象 7. 返回汇率信息ExchangeRateList 8. 经纬度返回百度坐标 9. 仅返回钟点房 11.返回新担保、新预付规则 一般情况下传入1,2,3,4 默认“1,2,3,4”

返回数据

名称	类型	是否必须	备注
code	number	必须	返回码 0：请求成功 3000：请求失败 5000：请求异常
message	string	必须	请求消息
success	boolean	必须	请求是否成功
data	object	必须
├─ hotels	object []	必须	酒店结果集
├─ hotelId	string	必须	酒店编号
├─ lowRate	number	必须	最低价格的货币 返回的是该酒店中所有符合查询条件的产品的最低价
├─ facilities	string	必须	酒店设置 1 免费wifi 2 收费wifi 3 免费宽带 4 收费宽带 5 免费停车场 6 收费停车场 7 免费接机服务 8 收费接机服务 9 室内游泳池 10 室外游泳池 11 健身房 12 商务中心 13 会议室 14 酒店餐厅 15 叫醒服务 16 行李寄存 17 双床 18 大床 以上是本接口使用的简略设施信息，与静态信息中获取的设施id并不对应。
├─ detail	object	必须	酒店详情信息
├─ hotelName	string	必须	酒店名称
├─ starRate	integer	必须	挂牌星级 此为酒店对外的挂牌星级（国家旅游局规定），0-无星级；1-一星级；2-二星级；3-三星级；4-四星级；5-五星级。当为0时对外显示可用Category的值，但请进行图标区分。
├─ category	integer	必须	推荐级别 推荐星级，而非酒店挂牌星级。对应值含义为：0,1,2：客栈；3：舒适；4：高档；5：豪华；A：公寓
├─ latitude	string	非必须	纬度 默认返回Google坐标系。 当ResultType中加入8后，输出为百度坐标。 其他坐标系请联系对应的厂商获取转换方法。
├─ longitude	string	非必须	经度 默认返回Google坐标系。 当ResultType中加入8后，输出为百度坐标。 其他坐标系请联系对应的厂商获取转换方法。
├─ address	string	非必须	地址
├─ phone	string	非必须	前台电话
├─ thumbNailUrl	string	非必须	酒店图片 小图(120x120, png), 入参ResultType传入3时返回，可以将该返回的链接上120_120替换为70_70获取更小的图片， 也可以替换为350_350获取更大的图片
├─ city	string	非必须	城市ID
├─ district	string	非必须	行政区ID
├─ businessZone	string	必须	商业区ID
├─ canSellFlag	integer	必须	是否可售 0不可售 1可售
├─ count	integer	必须	查询到的酒店总数
guid	string	必须	guid