內容

「內容 API」可讓您存取全部的 Rapid 旅宿內容。

旅宿內容

可針對要求存取的可預訂旅宿，以所要求的語言回傳旅宿 ID 清單，或完整旅宿內容。

您可使用此 API 根據搜尋條件來擷取旅宿 ID 或完整旅宿內容。例如：擷取自上星期一起新增的旅宿清單，或特定旅宿 ID 清單上的旅宿內容。

停用的旅宿

有時候，原本可預訂的旅宿已關閉，並從我們的庫存下架。您可以用「停用旅宿 API」來要求自指定日期後變成停用狀態的旅宿清單，藉此更新內容快取或儲存，以排除在 Rapid 中不可銷售或不可預訂的旅宿。

在下面的範例中，合作夥伴最後一次使用「旅宿內容 API」或「旅宿內容檔案 API」更新其內容快取或儲存是在 5 月 31 日。您會看到未排序的物件清單，內含應從合作夥伴系統中移除的 property_id。此端點可與以下「旅宿內容 API」端點上的一個或多個參數搭配使用，以更新您的內容快取或儲存：date_added_start、date_added_end、date_updated_start 或 date_updated_end。

範例：

要求：

https://test.ean.com/v3/properties/inactive?since=2023-06-01

回應：

[
  {
    "property_id": "10003243"
  },
  {
    "property_id": "10012775"
  },
  {
    "property_id": "10013765"
  },
  {
    "property_id": "10017071"
  },
  {
    "property_id": "10041102"
  },
  {
    "property_id": "10042"
  },
  {
    "property_id": "10074774"
  },
  {
    "property_id": "10089905"
  },
  {
    "property_id": "10091055"
  },
  {
    "property_id": "10268276"
  },
  {
    "property_id": "1029882"
  },
  {
    "property_id": "103115"
  },
  {
    "property_id": "10349744"
  },
  {
    "property_id": "10373667"
  },
  {
    "property_id": "1037667"
  },
  {
    "property_id": "1039715"
  },
  {
    "property_id": "10401509"
  },
  {
    "property_id": "104201"
  },
  {
    "property_id": "10465614"
  },
  {
    "property_id": "10484434"
  },
  {
    "property_id": "10488054"
  },
  {
    "property_id": "10520425"
  }
]

旅宿目錄檔案

傳回的連結可依所選語言來下載 Rapid 的可預訂旅宿主清單。回應內容包含各旅宿的高階詳細資料。

您可使用此檔案取得旅宿的完整清單。對應到其他供應商提供的旅宿清單時，旅宿詳細資料十分實用。

旅宿內容檔案

傳回的連結可依所選語言來下載 Rapid 的可預訂旅宿內容。此回應包含旅宿等級、客房等級和房價等級資訊。

可使用此檔案擷取所有旅宿的全部內容。如果您只需要旅宿的子集合，請改為使用「旅宿內容 API」。

連鎖旅宿參考資訊

回傳 Rapid 可辨識的連鎖旅宿全數匯整資料。

連鎖旅宿指的是旗下有多個相關品牌的母公司。

每個品牌只能隸屬一家連鎖旅宿。例如：Hilton Worldwide 是一家擁有多個品牌的連鎖飯店，旗下品牌包括 DoubleTree、Hampton Inn 與 Embassy Suites。

其他參考資訊

在地化

language 參數僅使用兩位數的語言與國家/地區代碼連字號配對，整合代碼前，請到這裡參閱我們的支援語言。

星級評等

「Rapid 內容 API」回傳的星級評等能為旅客提供指引，讓他們對於旅宿在家具、服務和設施服務方面有一般的合理期望。如需更多有關星級評等運作方式的資訊，請參閱這裡。

參考清單

「Rapid 內容 API」提供的旅宿資訊通常以 ID 顯示。請使用參考清單了解這些 ID 的意義。參考清單僅提供英文版，但在 API 中會回傳本地化名稱。

註冊編號

Rapid 內容 API 中的 registry_number 參數將回傳單一或多個註冊詳情。這些詳情會根據各個國家/地區的要求，含有單詞、字母、數字和特殊字元。我們提供這些數字，讓您能夠遵守法律和法規的顯示規定。

範例：

"registry_number": "Property Registration Number 004071AAA-00004, IT005748GHFMUHG",
"registry_number": "IT00574-8GHFMUHG",

庫存商機

EPS 入口網站中的「庫存商機」頁面將為您提供未對應旅宿的清單，並且都與您的 Rapid API 整合相關。我們經常變更住宿的供應量，因此您需要定期檢查，以便新增旅宿或將其對應到其他供應商的旅宿，這樣旅客就不會在您的網站上看到重複的旅宿或錯過新旅宿。

API 詳細資料

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

其他資源

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

前往 API Explorer