快速住宿 API 概覽

我們的模組化 API 將為您提供旅客完成旅宿預訂所需的所有數據點。可讀取區域定位、旅宿、房價及其他，端看您想建立什麼樣的使用者經驗。本頁面為您說明預訂路徑的運作方式。

如何建立預訂申請流程

以下是建立預訂路徑流程的簡易指南。當您準備好開始整合時，請參閱我們的 API 文件頁面，可以找到各 API 模組的詳細資訊。

旅宿目錄提供識別物業所需的核心資訊，包括旅宿識別碼、名稱與地址、聯絡資訊，以及星級評分。旅宿內容需要每日更新。

地理 API 可用來查詢已知的地理地區、地區階層等級，和特定地區內有空房的住宿。

可使用住宿日期、入住詳情和您要的住宿編號呼叫購物 API。

回應會傳回各家旅宿的所有空房，包括特定房價、費用，以及不同客房選項的取消規定。每則回傳的房型物件皆附上立即可用的記號化連結，以說明預訂流程的下一個步驟。

可使用付款選項連結來決定旅宿接受的付款選項。付款選項連結在預訂過程中隨時可用，就看您選擇何時讓旅客看見付款選項。

為預訂做準備時，請使用購物回應中price_checklink 物件的room 來驗證所選費率。

若房價相符的話，您會收到 MATCHED 的確認通知，以及預訂申請所需的連結值。若房價有所變更，您會收到新房價資訊和以新房價預訂的連結值。

請以預訂連結值、旅客資料和適用的付款資訊來發送預訂申請。

回應會傳回行程 ID 和連結，以擷取預訂詳細資料、取消預訂，或恢復預訂 (如果已建立保留預訂)。

我們建議您將檢索連結與每位旅客的詳細資料一併儲存，以便日後更快地檢索預訂資訊。

當您將所有資訊填入最終預訂確認頁面後，即表示您已完成預訂流程。請使用預訂回覆中提供的檢索連結，以檢索完整的行程記錄。

擷取回應可確認所有日期、房價、預訂房型、確認編號，以及預訂的現狀。

擷取回應可用來取得旅宿訊息中心的連結，是旅客和旅宿直接溝通的雙向通訊工具。擷取回應還提供了變更客房資料的選項，例如：客房名稱、可否吸煙或是否有特別要求。