创建订单

在百居易中创建订单(直订单)。

Body Params
integer
required

订单的房间 ID。

integer
required

订单的自定义渠道的 ID。请参阅 Query Custom Channel 以检索自定义渠道。

date
required

订单的入住日期,格式为 YYYY-MM-DD。

date
required

订单的退房日期,格式为 YYYY-MM-DD。

integer

订单中包含的客人总数。

string
required

主要客人的姓名。

string

主要客人的电子邮件地址。

string

主要客人的手机号码。

string
required

订单金额的货币代码。有关详细信息,请参阅 Supported Currencies

integer
required

订单的总房价金额。

integer
required

订单的佣金金额。

integer
required

收到的订单总金额。

integer
required

用于订单付款的收入方式的标识符。请参阅 Query Income methods 以检索所有收入方法。

string

与订单相关的任何附加备注。

string
length ≤ 32
^[A-Za-z0-9]+$

可选的外部订单号,通常是你自己系统中的订单 id。传入后创建即具备幂等性:在同一个 百居易 账号下,同一个 channel_id 只会产生一张订单,因此超时后重试不会建出重复订单。再次提交相同的 channel_id 会返回已存在的那张订单及其当前 status,而不是新建一张——请以 status 而非 HTTP 状态码作为判断依据,因为重放一张已被取消的订单同样返回 200。该值会存为订单的 channel_id,可通过 查询订单 反查。唯一性范围是 百居易 账号,而不是你的应用或自定义渠道;且该值一经使用即被永久占用,订单取消后也不释放。仅允许字母和数字,不接受任何标点(含连字符、下划线和点)。

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json