订单创建

测试环境

https://hudson-dev.localhome.cn

POST

/openapi/hotel/reserve

调用方式（HTTP Method）：POST

请求参数

Header 参数

Body 参数application/json

示例

{
    "checkin": "2030-01-01",
    "checkout": "2030-01-02",
    "channelHotelId": "123456",
    "channelOrderId": "123456",
    "hotelId": 1296369727399878700,
    "roomId": 1296369727399878700,
    "ratePlanId": 1296369727399878700,
    "orderDate": "new Date()",
    "roomNum": 1,
    "roomCustomers": [
        {
            "seq": 1,
            "adults": 2,
            "children": 0,
            "childrenAges": [
                0
            ],
            "customers": [
                {
                    "firstName": "SHAN",
                    "lastName": "ZHANG",
                    "nationality": "CN",
                    "gender": "MALE",
                    "age": 23
                }
            ]
        }
    ],
    "payType": "PREPAY",
    "currencyCode": "CNY",
    "promotionPrice": "public static final BigDecimal ZERO;",
    "totalPriceAndTax": 1000,
    "taxAndFee": 100,
    "dailyPrices": [
        {
            "date": "2030-01-10",
            "price": 500
        }
    ],
    "contactInfo": {
        "name": "ZHANG/SHAN",
        "phone": "0086-1234567890",
        "email": "mail@example.com"
    },
    "specialRemarks": "string",
    "extras": {
        "key": "string"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://hudson-dev.localhome.cn/openapi/hotel/reserve' \
--header 'Authorization: {{authorization}}' \
--header 'Timestamp: {{timestamp}}' \
--header 'PartnerId: 1758852059833961' \
--header 'Content-Type: application/json' \
--data-raw '{
    "checkin": "2030-01-01",
    "checkout": "2030-01-02",
    "channelHotelId": "123456",
    "channelOrderId": "123456",
    "hotelId": 1296369727399878700,
    "roomId": 1296369727399878700,
    "ratePlanId": 1296369727399878700,
    "orderDate": "new Date()",
    "roomNum": 1,
    "roomCustomers": [
        {
            "seq": 1,
            "adults": 2,
            "children": 0,
            "childrenAges": [
                0
            ],
            "customers": [
                {
                    "firstName": "SHAN",
                    "lastName": "ZHANG",
                    "nationality": "CN",
                    "gender": "MALE",
                    "age": 23
                }
            ]
        }
    ],
    "payType": "PREPAY",
    "currencyCode": "CNY",
    "promotionPrice": "public static final BigDecimal ZERO;",
    "totalPriceAndTax": 1000,
    "taxAndFee": 100,
    "dailyPrices": [
        {
            "date": "2030-01-10",
            "price": 500
        }
    ],
    "contactInfo": {
        "name": "ZHANG/SHAN",
        "phone": "0086-1234567890",
        "email": "mail@example.com"
    },
    "specialRemarks": "string",
    "extras": {
        "key": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{
  "success": false,
  "code": "",
  "message": "",
  "data": {
    "channelOrderId": "",
    "orderId": 0,
    "orderStatus": "",
    "orderMessage": "",
    "totalPriceAndTax": 0,
    "confirmId": "",
    "roomConfirmIds": [
      ""
    ]
  }
}

修改于 2025-10-14 03:28:32

订单取消