內容

Rapid Content API 可讓您存取 Rapid API's 旗下所有網站的內容。

旅宿內容 API

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

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

內容檔案 API

Rapid API 提供的一項功能，是能夠匯出目前有效的物業清單及其詳細資料。共有兩種檔案 API 可供選擇。

注意

內容檔案 API 對擴展的全球庫存支援有限，因此我們建議您改用內容 API。

進一步了解擴大的全球庫存

旅宿目錄檔案

此 API 會傳回一個連結，用以下載所請求語言中目前有效的房源清單。回應內容包含各旅宿的高階詳細資料。您可使用此檔案取得旅宿的完整清單。對應到其他供應商提供的旅宿清單時，旅宿詳細資料十分實用。

旅宿內容檔案

此 API 會傳回一個連結，用以下載所請求語言中所有已啟用房源的全部內容。此回應包含旅宿等級、客房等級和房價等級資訊。可使用此檔案擷取所有旅宿的全部內容。如果您只需要旅宿的子集合，請改為使用「旅宿內容 API」。

閒置物業

有時候，原本可預訂的旅宿已關閉，並從我們的庫存下架。已停用的旅宿 API 可用於查詢自指定日期起所有已停用的房源清單，讓您能更新內容快取或儲存空間，以排除該日期內無法出售或預訂的房源 Rapid API.

在下面的範例中，合作夥伴最後一次使用「旅宿內容 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=2027-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 API. 連鎖旅宿指的是旗下有多個相關品牌的母公司。

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

加州度假租屋的清潔工作

加州一項新法律規定，度假租賃房源必須向旅客揭露強制性的清潔工作。我們已對 API 進行了更新，讓您能夠顯示清潔任務。每位使用 Rapid API 的合作夥伴，均有責任確保清潔服務的展示方式符合法律規定。

有什麼變化？

我們已對「Rapid API」進行了優化，在「checkout」物件中新增了一個「指示」欄位，其中包含由度假租屋管理員提供的結帳說明。

範例：

"checkout": {
"instructions": "<ul>  <li>The host requests you complete the following cleaning tasks before checking out:</li><li>Start the dishwasher</li><li>Strip any used beds and gather used towels</li><li>Remove personal items</li><li>Turn off the lights</li>  </ul>"
}

其他參考資訊

在地化

language參數僅支援以連字號連接的「two-digit」語言與國家代碼組合，在整合任何代碼之前，請先查閱支援的語言清單。

星級評等

「Rapid 內容 API」回傳的星級評等能為旅客提供指引，讓他們對於旅宿在家具、服務和設施服務方面有一般的合理期望。進一步了解上的星級評分機制。

參考清單

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

註冊編號

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

範例：

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

內容