Rapid Lodging API 概覽
Rapid Lodging API 的設計宗旨,是讓您能直觀且輕鬆地建立預訂流程。
我們的模組化 API 將提供旅客完成旅宿預訂所需的所有資料點。可讀取區域定位、旅宿、房價及其他,端看您想建立什麼樣的使用者經驗。本頁面為您說明預訂路徑的運作方式。
如何建立預訂申請流程
以下是建立預訂路徑流程的簡易指南。當您準備好開始整合時,請參閱我們的 API 文件頁面,可以找到各 API 模組的詳細資訊。
步驟 1:取得靜態內容
旅宿目錄提供了您識別房產所需的核心資訊,包括旅宿編號、名稱與地址、聯絡資訊,以及的星級評分。旅宿內容需要每日更新。
步驟 2:取得地理資訊
地理 API 可用 來查詢已知的地理地區、地區階層等級,和特定地區內有空房的住宿。
步驟 3:瀏覽房產
可使用住宿日期、入住詳情和您要的住宿編號呼叫購物 API。
回應會傳回各家旅宿的所有空房,包括特定房價、費用,以及不同客房選項的取消規定。每則回傳的房型物件皆附上立即可用的記號化連結,以說明預訂流程的下一個步驟。
查看付款方式
可使用付款選項連結來決定旅宿接受的付款選項。付款選項連結在預訂過程中隨時可用,就看您選擇何時讓旅客看見付款選項。
在預訂前,請使用購物回應中price_checklink 物件的room 來驗證所選的費率。
步驟 4. 查看價格並取得預訂連結
若房價相符的話,您會收到 MATCHED 的確認通知,以及預訂申請所需的連結值。若房價有所變更,您會收到新房價資訊和以新房價預訂的連結值。
請以預訂連結值、旅客資料和適用的付款資訊來發送預訂申請。
步驟 5:訂房回覆
回應會傳回行程 ID 和連結,以擷取預訂詳細資料、取消預訂,或恢復預訂 (如果已建立保留預訂)。
連結存檔
我們建議您將預訂連結與每位旅客的詳細資料一併保存,以便日後能更快地調閱預訂資訊。
當您在最終預訂確認頁面上填寫完所有資訊後,即表示您已完成預訂流程。請使用預訂回覆中提供的檢索連結,以檢索完整的行程記錄。
步驟 6. 擷取行程記錄
擷取回應可確認所有日期、房價、預訂房型、確認編號,以及預訂的現狀。
擷取回應可用來取得旅宿訊息中心的連結,是旅客和旅宿直接溝通的雙向通訊工具。擷取回應還提供了變更客房資料的選項,例如:客房名稱、可否吸煙或是否有特別要求。
與我們的認證技術合作夥伴之一合作
您是否傾向將 Rapid Lodging API 的開發工作外包?您可以與我們的「精英」或「首選」技術合作夥伴合作,由他們為您設計、建置並優化系統整合方案,讓您能以更少的內部開發資源,更快地上線運作。