预订
预订 API 允许您预订经价格检查响应确认的房型和房价。
预订 API 的主要行程方法可创建所选住宿、客房、房价和入住人数的预订。付款信息(包括账单/持卡人联系信息)直接在请求中提供。
每个成功的预订响应均包含用于检索行程或取消订单的链接。有关详细信息,请参阅我们的管理预订部分和处理预订请求页面。
要进行 multi-room 预订(相同房型),您必须首先发出 购物 API 请求,并为每个房间传递单独的 occupancy
参数。然后,在预订请求中,在 room
数组中为您想要预订的每个房间包含相应的 rooms
单独实例。
要在完成预订前短暂保留库存(例如建立套餐),请参考保留与继续文档。
如需进行测试预订(不会从您的卡中扣费或者付费给住宿),请参阅测试请求文档。
预订链接失效
经过一段较短的时间后,之前的价格检查响应中的预订链接将失效。如果您在首次尝试后收到 HTTP 503 错误,则该链接可能已失效。请获取新链接并再次尝试进行预订。
INR 和 BRL 预订的税号
由于监管税收要求,一些以印度卢比 (INR) 和巴西雷亚尔 (BRL) 进行的 Rapid API 交易需要在 tax_registration_number
参数中输入付款旅客的有效个人税号。
如果此参数留空或提供的税号无效,则创建预订 API 的请求可能会失败。请求将返回 HTTP 400 错误,并在消息中描述错误来源为 tax_registration_number
。应通过将 tax_registration_number
更新为有效的税号并重新发送创建预订请求来纠正此问题。
API 详情
查看此页面上与预订相关的端点定义,然后使用 API Explorer 或其他测试软件来了解示例和模式定义与实际输出的比较。
其他资源
无论您是想尝试所有 Rapid API 端点还是下载其 OpenAPI 规范或我们的 Postman 集合,我们都能满足您的需求。