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