內容

快速內容 API 為您提供對 Rapid API 所有屬性內容的存取權限。

屬性內容 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=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 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",

內容