Rapid Lodging API 全球庫存擴充

憑藉全球擴展的庫存規模，在國際市場上展開競爭

Expedia 擴展全球庫存 (EGI) 助您與全球逾 34,000 間住宿設施競爭，且庫存數量持續定期增加。這包括新取得的物業以及現有物業的額外庫存。

技術細節

EGI 並非 Rapid API, 的標準庫存項目，但可根據需求明確啟用。其動態行為與整合模式有別於標準庫存系統，在內容攝取、購物及預訂工作流程中皆需特別留意。

內容檔案

目前針對 EGI 的快速內容檔案與目錄檔案 API 僅支援 English-language 內容。若您的系統需要在地化內容檔案（non-English)，可透過以下 API 在本地端生成：內容 API：旅宿地理位置 API： 地理位置 API： 這些 API 提供支援所有內容語言的 real-time 串流與彈性資料處理功能，讓您能輕鬆從 JSON-formatted API 回應中擷取所需資訊。您可以將原始 JSON 回應儲存於本地端以供後續處理，或進行轉換以供資料庫匯入或其他用途。

使用地理位置 API 請求區域屬性清單的範例：

/regions?country_code=US&language= it-IT&include=property_ids_expanded&include=property_ids

使用旅宿內容 API 請求目錄內容的範例：

/properties/content?language=it-IT&supply_source=expedia&property_id={property_id}&include=catalog

您可以選擇優先啟動 EGI 的內容整合功能，同時預留額外時間審核購物與預訂流程；或者在準備就緒時，將這三個組件一併啟動。有關配置的詳細資訊，請聯繫您的整合顧問。

客房資料對齊

在您的系統與旅宿內容 API 完全同步之前，新的旅宿房間可能會出現在購物 API 中。為維持一致的使用者體驗，請考慮採取以下任一措施：暫時將這些房間排除於客戶端顯示範圍外、觸發針對新代號客房的 real-time 內容 API 呼叫，或提高本地內容更新頻率以減少資料延遲。

費率識別碼

EGI 費率的結構有別於標準庫存，並遵循更動態的數據模型。由於這些費率沒有靜態值，購物 API 會以動態的rate_id 值回傳，該值與內容 API 中的旅宿欄位值不對應。此動態字串值由數字、字母及各類符號組成，其內容可能在每次購物 API 回應中有所不同。因此，rate_id 值不穩定，不應作為持久識別碼或主鍵使用。若您的系統需要區分不同流程的費率，請考慮透過政策屬性與報價特徵的組合來進行匹配。請參閱這份安全文件 以獲取更多詳情。

購物 API 回應中「rate_id」值的範例：

[
  {
    "property_id": "ABC152",
    "status": "available",
    "rooms": [
      {
        "id": "XYZ652",
        "room_name": " Deluxe Double ",
        "rates": [
          {
            "id": "5K|Pa7xbx4z||GCogh8-B96OEY3-f9326e292|UFO",
            … …

床鋪配置的可變性

在特殊情況下，某些房間可能沒有指定的床鋪配置，此狀態將透過內容與購物 API 以「bed_groups」ID 值為 0 及描述「床鋪未指定」的方式標示。這意味著旅宿將決定床鋪的配置方式。check-in. 雖然這種情況較為罕見，但貴系統應持續向客戶通報相關資訊，若客戶有強烈偏好，則應協助其向我們的客戶營運團隊提出特殊要求。

購物 API 回應中未指定床鋪配置的範例：

{
  "bed_groups": {
    "0": {
      "id": "0",
      "description": "Bed Not Specified",
      "links": {
        "price_check": {
          … …

保留和復原

某些 EGI 費率與預訂 API () 的暫停與恢復 () 工作流程不相容，若嘗試暫停將返回錯誤。為避免造成不佳的客戶體驗，您可於購物 API 回應中請求「可保留率標記」，並依據該標記套用正確的工作流程。

請求可持有利率標記的範例：

Request:
/properties/availability?... …&include=rooms.rates.holdable

Response:
… …
"rooms": [
  {
    "id": "XYZ652",
    "room_name": "Deluxe Double Room",
    "rates": [
      {
        "id": "5K|Pa7xbx4z||GCogh8-B96OEY3-f9326e292|UFO",
        “holdable”: true,
        … …

Post-booking 功能

透過預訂 API 確認預訂後，該預訂將透過管理預訂 API 進行傳送。 用於存取 post-booking 功能 (包括 Soft Change、Hard Change 及旅宿訊息中心) 的代幣連結，亦將透過「管理預訂」API 提供。偶爾，代幣連結可能需要長達五分鐘才能準備就緒。請注意，這些功能並非適用於所有預訂，應在您的系統中妥善管理。

EGI 的關鍵差異