3.4获取酒店实时可订产品列表

POST

/open/corp/hotel/book/roomList

最后修改时间：2026-02-26 09:39:49

获取实时可预定酒店的产品列表，此接口房态和产品较listByHotelId较为准确。使用建议：酒店详情页时传入hotelID查询所有可预订产品，用户点击预订单个产品进入订单填写页面时传入productRoomId来查询获取最新价格。
频率限制：10次/S

请求参数

Body 参数application/json

示例

{
    "hotelId": "1805940519466315778",
    "productRoomId":"",
    "checkinDate":"2025-01-08",
    "checkoutDate":"2025-01-09",
    "num":1
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://api.test.yxjtrip.com/core/open/corp/hotel/book/roomList' \
--header 'Content-Type: application/json' \
--data-raw '{
    "hotelId": "1805940519466315778",
    "productRoomId":"",
    "checkinDate":"2025-01-08",
    "checkoutDate":"2025-01-09",
    "num":1
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "msg": "string",
    "data": [
        {
            "id": "string",
            "hotelId": "string",
            "roomName": "string",
            "roomSize": "string",
            "roomTypeId": "string",
            "roomTypeName": "string",
            "tags": "string",
            "bedAdd": "string",
            "windows": "string",
            "breakfast": "string",
            "invoiceMode": "string",
            "invoiceType": "string",
            "bookEarliestDay": 0,
            "bookTodayTime": "string",
            "bookLatestDay": 0,
            "bookPrice": 0,
            "status": "string",
            "cancelType": "string",
            "cancelTime": "string",
            "confirmType": 0,
            "saleStatus": "string",
            "peopleNum": 0,
            "minSerialStay": 0,
            "maxSerialStay": 0,
            "minRoomCount": 0,
            "maxRoomCount": 0,
            "origin": "string",
            "roomCancelRuleList": [
                {
                    "cancelFeeBaseType": "string",
                    "cancelType": "string",
                    "cancelDay": "string",
                    "cancelTime": "string",
                    "cancelAllRate": "string",
                    "cancelAmount": "string",
                    "night": "string"
                }
            ],
            "roomSaleStatusList": [
                {
                    "date": "string",
                    "salesPrice": 0,
                    "saleStatus": "string",
                    "price": 0,
                    "breakfast": 0,
                    "roomProductId": "string"
                }
            ]
        }
    ]
}

修改于 2026-02-26 09:39:49

3.2获取酒店产品列表

3.5可预订产品房态