四季酒店API

提交预定

开发中

POST

/api/v1/reservation/book

请求参数

Header 参数

Authorization-AppKey

string

必需

默认值:

Authorization-Sign

string

必需

默认值:

Authorization-Token

string

可选

默认值:

Body 参数application/json

channel_info

object

渠道来源

可选

channel_id

string

渠道ID

可选

xiaohongshu-小红书 baidu-百度

keyword

string

渠道关键字

可选

小红书的click_id/百度的bd_vid

hotel_id

string

酒店编码

必需

checkin

string

入住日期

必需

YYYY-MM-DD

checkout

string

离店日期

必需

YYYY-MM-DD

room_count

integer

房间数量

必需

adult_count

integer

成人数量/间

必需

child_count

integer

儿童数量/间

可选

child_ages

array[integer]

儿童年龄，数组个数和儿童数量一致

可选

room_id

string

房型ID

必需

rate_id

string

rateID

必需

guests

array [object {4}]

必需

room_sort

string

房间序号，1开始

必需

first_name

string

名

必需

last_name

string

姓

必需

area_code

string

国家/地区代码

必需

amount_before_tax

array[number]

税前房价

必需

amount_after_tax

array[number]

税后房价

必需

amount_before_tax_cny

array[number]

税前人民币房价

必需

amount_after_tax_cny

array[number]

税后人民币房价

必需

currency

string

币种

必需

payment_type

string

支付方式 WECHAT-微信

必需

示例

{
    "channel_info": {
        "channel_id": "string",
        "keyword": "string"
    },
    "hotel_id": "string",
    "checkin": "string",
    "checkout": "string",
    "room_count": 0,
    "adult_count": 0,
    "child_count": 0,
    "child_ages": [
        0
    ],
    "room_id": "string",
    "rate_id": "string",
    "guests": [
        {
            "room_sort": "string",
            "first_name": "string",
            "last_name": "string",
            "area_code": "string"
        }
    ],
    "amount_before_tax": [
        0
    ],
    "amount_after_tax": [
        0
    ],
    "amount_before_tax_cny": [
        0
    ],
    "amount_after_tax_cny": [
        0
    ],
    "currency": "string",
    "payment_type": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://fourseasons-test.e.verystar.net/api/v1/reservation/book' \
--header 'Authorization-AppKey;' \
--header 'Authorization-Sign;' \
--header 'Authorization-Token: fake_001' \
--header 'Content-Type: application/json' \
--data-raw '{
    "channel_info": {
        "channel_id": "string",
        "keyword": "string"
    },
    "hotel_id": "string",
    "checkin": "string",
    "checkout": "string",
    "room_count": 0,
    "adult_count": 0,
    "child_count": 0,
    "child_ages": [
        0
    ],
    "room_id": "string",
    "rate_id": "string",
    "guests": [
        {
            "room_sort": "string",
            "first_name": "string",
            "last_name": "string",
            "area_code": "string"
        }
    ],
    "amount_before_tax": [
        0
    ],
    "amount_after_tax": [
        0
    ],
    "amount_before_tax_cny": [
        0
    ],
    "amount_after_tax_cny": [
        0
    ],
    "currency": "string",
    "payment_type": "string"
}'

返回响应

🟢200成功

application/json

Body

order_sn

string

订单编号

必需

package

string

支付参数

必需

唤起请求数据-公众号支付，APP（应用）,MINIAPP(小程序)所需要的package数据包，已经是完整的数据，直接调用即可

示例

{
    "order_sn": "string",
    "package": "string"
}

修改于 2025-03-04 02:17:18

错误码列表

预定默认日期