預訂
「預訂 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 Collection,我們都可協助您完成。