检索符合条件酒店房型
说明:请求方法: 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 账号停用(商户账号,商户主账号