检索符合条件酒店房型
说明:请求方法: POST
请求数据类型: JSON
响应类型: JSON
请求头:"Accept":"application/json",
"Content-Type":"application/json"
接口描述: 针对特定酒店检索其房间信息
请求方式:POST(HTTPS)
请求地址:https://btbapi.sctt.net/h1/GetRoomTypes
请求包体:
{ "merchant_id":287729, "request_time":"2023-02-11 11:48:00", "sign":"D19A61DBE64BA6CFB547855F216E0201", "hotelUuid":"00d507f7-ca63-43b1-b1ac-5c09ea0ac71c", "data":{ "arrival":"2023-03-24", "departure":"2023-03-26", "cityCode":"SYD", "passengerCountryOfResidence":"CN", "nationality":"CN" } }
参数说明:
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
merchant_id | 是 | bigint | 商户编号 |
request_time | 是 | string | 请求时间,格式:“yyyy-MM-dd HH:mm:ss” |
sign | 是 | string | 签名 |
hotelUuid | 是 | string | 酒店编码 |
data | 是 | object | 酒店请求信息 |
- nationality | 是 | string | 入住人员的国籍 (ISO二 位国家代码 如:CN, AU,NZ) |
- passengerCountryOfResidence | 是 | string | 入住人员的居住国 (ISO 二位国家代码 如: CN,AU,NZ) |
- roomGuests | 否 | array[object] | 入住客人信息实体 |
- - adults | 是 | number | 入住成人数,必须 大于 0,小于9 |
- - children | 是 | number | 入住儿童数,必须 大约 等于0 |
- - childrenAges | 否 | string | 儿童年龄列表,如 果 “children”字 段设置了大于 0的 值,此字段需要以 逗 号分隔的形式给 出儿童年 龄的列表。比如随行两名 儿 童,此字段需要写 入 “3,5”。年龄 的范围为:0- 16岁 |
- arrival | 是 | string | 入住时间,日期格式:yyyy- mmdd。预订晚 数没有限定, 但晚 数过多就没有查询 结 果。如果拿到了 查询结 果,那就说 明是可以预定 的 |
- departure | 是 | string | 退房时间,日期格式:yyyy- mm-dd |
- cityCode | 是 | string | 城市编码,必须使 用文 档参数部分中 的编码 |
- currency | 否 | string | 目前统一用AUD |
- rooms | 否 | number | 预订房间数量。一 般情况 下,房间数 量不能大于10 间 |
- locale | 否 | string | 信息描述语言,备 选数 值:"zh_CN"中 文,"en_AU"英文 |
返回结果:
{ "code": 0, "msg": "ok", "data":{ "payload": [ { "roomTypeCode": "Deluxe City King Room ", "coziRoomUuid": "5c55a9de-5b5a-4695-bb3b-08075f6da906", "roomDescriptionLong": "Filled with natural light, these rooms offer the perfect place to relax after a long day of meetings or sightseeing with a king-size bed, a lounge chair and a bath tub, all inviting you to unwind. ", "bedTypeDesc": "1张超大号双人床", "maxChildren": 1, "maxAdult": 2, "roomDescription": "Deluxe City King Room ", "childOccupancy": 1, "rateInfos": [ { "roomBookingInfo": { "roomBookingUuid": "064eec46-99e2-4fcb-bf22-5802ebe9c4b8" }, "minStays": 1, "onRequest": false, "mealsPlan": { "description": null, "breakfast": false }, "chargeableRate": { "total": 462.0, "secondaryCurrency": "AUD", "currency": "AUD", "secondaryPrice": 462.0 }, "packageRate": false, "optionalMealsPlan": [ { "childBreakfastPrice": 60, "adultBreakfastPrice": 60, "provider": "EBOOKING", "childAgeFrom": 0, "childAgeTo": 12, "currency": "AUD", "breakfastType": "Breakfast", "breakfastId": "91467096-6389-40f6-86ab-634a47ea28d3", "providerInfo": null } ], "freeCancellation": true, "deadLine": "2023-02-25" } ], "roomSize": "26", "bedTypeDescEn": "1 Kingbed", "maxOccupancy": 2, "bedTypes": [ { "count": 1, "description": "1张超大号双人床", "id": "class com.cozitrip.cicada.domain.BedConfigK" } ], "smokingPreferences": "Non" } ], "status": 0 } }
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 状态码 |
msg | string | 接口返回信息 |
data | object | 接口返回数据 |
- status | number | 0表示成功,其他表示失败 |
- payload | object | 酒店房间信息 |
- - roomTypeCode | string | 房间代码(房间名称) |
- - roomDescription | string | 房间描述 |
- - roomDescriptionLong | string | 房间描述信息 |
- - roomSize | string | 房间面积 |
- - roomImages | array[object] | 房间图片 |
- - imageUrl | string | 图片的链接地址 |
- - rateInfos | array[object] | 费率信息列表 |
- - - freeCancellation | boolean | 是否可免费取消 |
- - - onRequest | boolean | 是否可以在线上预 定,不能的话需要 联系 SCTT工作人员 |
- - - deadLine | string | 免费取消必须在此 日期 之前 |
- - - chargeableRate | object | 房间价格信息 |
- - - - secondaryPrice | number | 一个房间所有晚上 的价 格 |
- - - - secondaryCurrency | string | 币种三字码,现在默认AUD |
- - - cancellationDesc | string | 取消预定的相关说 明 |
- - - roomBookingInfo | object | 标识费率的唯一对 象,在预订时需要 指定此 费率标识。 注意:这个 信息具 有时效性,失效 时 间约为8个小时。此 信息失效后,需要 重新 进行查询 |
- - - - roomBookingUuid | string | 费率标识代码 |
- - - mealsPlan | object | 早餐计划。如果包 含早 餐,所有人早 餐价格都 包含在总 价中。 |
- - - - breakfast | boolean | 是否包含早餐 |
- - - - description | string | 如果包含早餐,此 字段 将描述早餐的 类型:Full breakfast, Continental等 |
- - - optionalMealsPlan | array[object] | 可选的早餐计划。 用户 在预订时可以 指定是否 需要一同 预订早餐 |
- - - - breakfastType | string | 早餐类型(文字描 述) |
- - - - adultBreakfastPrice | number | 成人早餐价格。注 意:这个价格是单 价,计 算价格是需 要乘以入住 人数 |
- - - - childBreakfastPrice | number | 儿童早餐价格。注 意:这个价格是单 价,计 算价格是需 要乘以入住 人数 |
- - - - childAgeFrom | number | 计算儿童年龄区间 的最 小值 |
- - - - childAgeTo | number | 计算儿童年龄区间 的最 大值 |
- - - - provider | string | 供应商标识 |
- - - - breakfastId | number | 可选早餐编码 |
- - - - currency | string | 早餐价格的币种 |
- - bedTypes | array[object] | 床型信息列表 |
- - - id | number | 床型编码 |
- - - description | string | 床型描述信息 |
- - - count | number | 房间中床的数量 |
- - occupancyDesc | string | 房间可容纳人数描 述信 息 |
- - bedTypeDesc | string | 床型相关的信息 |
- - facitilyDesc | string | 房间设置的描述信 息 |
状态码说明:
状态码 | 说明 |
---|---|
0 | 获取酒店房间信息成功(其他表示失败 |
4001 | 报文错误 |
4002 | 签名错误 |
4003 | 账号停用(商户账号,商户主账号 |