说明
接口仅支持json格式请求。
如果入住客人中有小孩，请求的时候一定需要传入小孩信息，国外酒店小孩会影响总价格；
输入参数
| 节点 | 类型 | 名称 | 必填项 | 说明 |
|---|---|---|---|---|
| iHotelId | int | 酒店ID | Y | |
| productId | string | 产品ID | Y | 1-仅限于订单填写页面核验产品 2-严禁使用此参数自动遍历产品报价，造成接口访问异常，艺龙有权在未告知的前提下关闭账号。 |
| checkInDate | date | 入住时间 | Y | yyyy-MM-dd |
| checkOutDate | date | 离店日期 | Y | yyyy-MM-dd |
| roomGroup | Room[] | 房间信息，包含多个#Room | Y | 常用设置为1个房间2个成人 |
| options | string | 返回结果参数 | 默认返回产品信息 1 - 返回产品信息和静态信息 3 - 只返回静态信息Detail节点，若只取静态信息，可设置这个参数 |
Room节点
| 节点 | 类型 | 名称 | 说明 | 必填项 |
|---|---|---|---|---|
| childAges | String | 儿童年龄 | 儿童个数大于0时必填,儿童数量为0时请设置为null，多个儿童年龄用逗号隔开； 如果入住客人中有小孩，在带上productId请求的时候一定需要传入小孩信息，国外酒店小孩会影响总价格; | |
| numberOfAdults | Int | 成人人数 | Y |
响应结果
Result节点
| 节点 | 类型 | 名称 | 说明 |
|---|---|---|---|
| HotelId | int | 酒店ID | |
| logId | string | 日志ID | 接口遇到问题，请提供此日志ID用于跟踪日志 |
| LowestPrice | Int | 最低价 | |
| Detail | Array | 酒店静态信息 | 默认不返回,通过入参options控制； 参考#Detail |
| Products | Array | 产品信息 | 参考#Product |
Detail节点
| 节点 | 类型 | 名称 | 说明 |
|---|---|---|---|
| HotelNameCn | string | 酒店中文名 | 可能没有翻译和英文名是一样的 |
| HotelNameEn | string | HotelNameEn | |
| OpenningDate | date | 开业时间 | |
| LastDecorateDate | date | 最后装修时间 | |
| Star | Int | 酒店星级 | |
| SummaryCn | string | 中文简介 | |
| SummaryEn | string | 英文简介 | |
| AddressCn | string | 中文地址 | |
| AddressEn | string | 英文地址 | |
| AcceptCreditCards | string[] | 可接受的信用卡 | |
| HotelFacilities | string[] | 酒店设施 | |
| HotelPlicy | string | 酒店政策 | |
| HotelFee | string | 酒店费用说明 | |
| HotelImages | string[] | 酒店图片 | |
| AddressEn | string | 英文地址 | |
| HotelTelephone | string | 前台电话 | |
| RegionInfo | Array | 查询的区域信息 | 参考#RegionInfo |
| GeoInfo | Array | 地理信息 | 参考#GeoInfo |
| Brand | int | 品牌ID | 名称参考对照表 |
| Information | string | 敬请注意 | |
| CommentScore | int | 酒店评分 | |
| CheckIn | string | 这个时间之后入住 | |
| CheckOut | string | 这个时间之前离店 |
RegionInfo节点
| 节点 | 类型 | 名称 | 说明 |
|---|---|---|---|
| RegionId | int | 地区编号 | |
| RegionNameCn | string | 地区中文名 | |
| RegionNameEn | string | 地区英文名 | |
| CountryCode | string | 国家编号 | |
| CountryNameCn | string | 国家名称 | |
| CountryNameEn | string | 国家英文名称 |
GeoInfo节点
| 节点 | 类型 | 名称 | 说明 |
|---|---|---|---|
| Longitude | decimal | 经度 | |
| Latitude | decimal | 纬度 |
Product节点
| 节点 | 类型 | 名称 | 说明 |
|---|---|---|---|
| ProductId | string | 产品唯一编码 | 成单需要的产品ID |
| RoomName | string | 房型名称 | |
| ProductDesc | string | 产品描述 | |
| TotalPrice | decimal | TotalPrice | 系统已经处理为单个房间的房费(订单填写多间的时候需要乘以间数)，包含了房费、税费、服务费和加人费，不包括保险 |
| CostTotalPrice | decimal | 总结算价 | 当采用结算价模式的时候才返回，成单的总价计算将以结算价为基础了。系统已经处理为单个房间的房费(订单填写多间的时候需要乘以间数)。 |
| NightlyPrices | NightlyPrice[] | 每晚房费 | 参考#NightlyPrice |
| AveragePrice | decimal | 房费的均价 | |
| CostAveragePrice | decimal | 房费的结算均价 | |
| TaxesAndFees | decimal | 税和服务费 | |
| ExtraPersonFees | decimal | 加人费 | |
| unIncludeTotal | decimal | 到店另付费 | |
| unIncludeList | unIncludeList[] | 到店另付费明细列表 | |
| CancellationType | int | 取消类型 | 0-不可取消 1-限时取消 |
| CancellationDesc | string | 取消政策描述 | |
| CancellationLists | CancellationList[] | 取消政策 | 参考#CancellationList |
| CurrentAlloment | int | 可用库存 | |
| MaxPersonNum | Int | 最多入住人数 | 返回结果中无此参数的话，请忽略此参数 |
| ArriveStartTime | string | 最早到达时间 | 如果为空，默认酒店当地时间14点(可以办理入住的时间) |
| ArriveEndTime | string | 最晚到达时间 | 如果为空，默认酒店当地时间24点 |
| Breakfast | string | 早餐信息 | 表示该产品是否含早，不用做早餐份数的判断 |
| BreakFastDesc | string | 早餐描述 | 早餐的具体描述 |
| BreakFastNum | int | 早餐份数 | 早餐的份数信息，产品的具体早餐份数以此字段的描述为准 |
| Internet | string | 网络使用信息 | |
| isInstantConfirm | int | 是否立即确认 | 0：不是立即确认；1-是立即确认 |
| SmokingPreference | string | 吸烟信息 | |
| FacilityList | string[] | 房间设施 | |
| GiftIds | string[] | 送礼活动 | 关联Gifts |
| BedTypes | BedType[] | 床型 | 如果出现多个，下单的时候需要选择; 参考#BedType |
| RoomImageList | string[] | 房型图片列表 | |
| MroomId | int | 房型聚合ID | 聚合的房型ID;int64类型；[仅供参考，此信息引起的投诉，艺龙免责] |
| MroomName | string | 房型聚合名称 | [仅供参考，此信息引起的投诉，艺龙免责] |
| MroomNameEn | string | 房型聚合英文名称 | [仅供参考，此信息引起的投诉，艺龙免责] |
| BreakfastFilter | string | 早餐筛选ID | 详情页做筛选项使用 |
| InternetFilter | string | 网络筛选ID | 详情页做筛选项使用 |
| CancelFilter | string | 取消类型筛选ID | 详情页做筛选项使用 |
| BedtypeFilter | string | 床型筛选ID，多个逗号分隔 | 详情页做筛选项使用 |
| Nationality | Int | 仅限中国国籍 | 1--仅限中国国籍的客人入住 |
| EnableRemark | Int | 是否支持下单备注 | 1--支持备注 |
NightlyPrice节点
| 节点 | 类型 | 名称 | 说明 |
|---|---|---|---|
| Date | Date | 在店日期 | |
| BasePrice | decimal | 原始房价 | |
| CurrentPrice | decimal | 当日销售房价 | 卖价 |
CancellationList节点
| 节点 | 类型 | 名称 | 说明 |
|---|---|---|---|
| StartDate | Date | 开始时间 | 北京时间 |
| EndDate | Date | 结束时间 | 北京时间 |
| LocalStartDate | Date | 当地开始时间 | 酒店当地时区 |
| LocalEndDate | Date | 当地结束时间 | 酒店当地时区 |
| Refundable | string | 是否可退款 | 0-不可退款; 1-可退款 |
| CustomerPrice | decimal | 客人罚金 | 当可退款的时候才看这个属性决定罚金是多少。不可退款的时候可以理解为罚金就是总金额 |
BedType节点
| 节点 | 类型 | 名称 | 说明 |
|---|---|---|---|
| BedTypeId | string | 床型编码 | |
| BedTypeName | string | 床型 |