Developer Hub
此為系統自動產生的翻譯

預訂

「預訂 API」可讓您預訂客房,且房型和房價已由價格檢查回應確認。

「預訂 API」的主要行程方式,會針對選取的旅宿、客房、房價和入住率建立預訂。要求當中會直接提供帳單/持卡人聯絡資訊等付款資訊。

每個執行成功的預訂回應皆會包含連結,以取回行程或取消預訂。詳情請參閱我們的管理預訂專區,以及處理預訂請求 頁面。

若要預訂客房類型的 multi-room 訂位,您必須先發出Shopping API請求,並針對每個客房傳入獨立的occupancy參數。接著,在預訂請求中,針對您欲預訂的每個客房,請在 room 陣列中加入相應的獨立 rooms 實例。

若要在完成預訂前短期保留可訂空房 (例如建立套裝行程),請參閱我們的「暫停與繼續處理」說明文件。

若要執行信用卡不扣款或不傳送至旅宿的測試預訂,請參閱我們的「測試要求」說明文件。

預訂連結過期

來自先前「價格檢查」回應的預訂連結,會在短時間內到期。若您在第一次嘗試時收到 HTTP 503 錯誤,表示連結可能已到期。請取得新連結並重新嘗試預訂。

INR 和 BRL 預訂的稅務編號

基於稅務法規要求,部分以印度盧比 (INR) 及巴西雷亞爾 (BRL) 進行的 Rapid API 交易,需在tax_registration_number 參數中提供付款旅客的有效個人稅務識別號碼。

若此參數留空或提供無效的稅務識別號碼,來自「建立預訂」API 的請求可能會失敗。要求會回傳 HTTP 400 錯誤,以及錯誤原因為tax_registration_number的訊息。為修正此問題,請將 tax_registration_number 更新為有效稅務編號,並重新傳送「建立預訂」要求。

制裁

制裁是指針對受制裁對象實施的經濟與貿易限制措施。聯合國共有 30 項制裁機制,包括針對伊拉克、伊朗、蘇丹、葉門,以及針對「伊斯蘭國」(ISIL) 、Al-Qaida, 和塔利班的制裁。美國、歐盟和英國也各自實施針對恐怖分子、毒品販子以及危害國家安全者的制裁措施。在美國、歐盟或任何聯合國成員國註冊成立的公司,均須遵守這些制裁措施。

Rapid 如何確保遵守制裁規定?

我們已新增一項功能,讓您能在預訂時記錄旅客的更多詳細資料,包括出生日期、全名及地址。這些資料隨後會匯入我們的詐欺與風險團隊所使用的案件管理工具中,用於制裁篩查。

有關制裁篩查的其他欄位,請參閱sensitive_traveler_details 中的「建立預訂」資料結構。此功能將於 2026 年 1 月起開放使用。

API 詳細資料

在這個頁面上探索預訂相關端點的定義,然後使用 API Explorer 或其他測試軟體,了解範例和結構描述定義與實際輸出的比較。


其他資源

無論您是想嘗試所有 Rapid API 端點,還是下載其 OpenAPI 規格或我們的 Postman Collection,我們都可協助您完成。



這個頁面有幫助嗎?
我們能如何改善內容?
感謝您協助我們進行改善!