運作方式

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

如何建立預訂申請流程

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

旅宿目錄提供辨識旅宿所需的基本資訊，包含旅宿編號、名稱和地址、聯絡資訊和星級評等。旅宿內容需要每日更新。

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

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

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

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

在準備預訂前，請使用「購物」回應的 room 物件所附的 price_checklink 來確認所選的房價。

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

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

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

建議您將擷取連結存檔在旅客資料中，將來擷取預訂資訊時可節省時間。

將全部資訊新增在最終預訂確認頁面即可，這樣就建立好預訂路徑了。

可使用預訂回應提供的擷取連結來擷取完整行程記錄。

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

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