搜尋與篩選

輕鬆搜尋並篩選 Rapid Content API 的回應，以獲得更精準的結果。

您可以利用 Rapid Content API 的搜尋和篩選功能，來控制回應中收到的旅宿資訊內容。這使您能夠精簡接收的數據，並僅獲取旅客所需的信息，從而降低成本並提升靈活性。

搜尋

請使用搜尋功能，尋找提供特定設施或服務的住宿，例如具備進階永續發展功能的住宿。

您可以透過以下 property-level 元素進行搜尋：

category_id: 分類
all_inclusive：All-inclusive 狀態
attribute_id: 屬性
amenity_id: 旅宿級別的設施
spoken_language_id: 使用的語言

備註：此功能不包括特定的客房或房價計畫元素。

請求範例 1

在此範例中，我們使用搜尋參數 ``amenity_id 來限制回傳的物件。

curl -X GET "https://test.ean.com/v3/properties/content\
?language=en-US\
&supply_source=expedia\
&amenity_id=115\
&include=property_id\
&property_id=1337\
&property_id=1" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

回應範例 1

從這則回應中可以看出，系統僅回傳旅宿 1337，因為旅宿 1 沒有可用設施 ID 115。

{
  "1337": {
    "property_id": "1337"
  }
}

如需查看所有可用屬性、設施、使用語言及類別的完整清單，請參閱中的內容參考清單。

篩選

您可以僅請求所需的 top-level 區段，如此一來，便無需接收完整的旅宿詳細資訊，即可獲取部分回應內容。請使用 ``include 參數來指定您想要的區段。結果將包含property_id，以及根據旅宿所要求的各部分。

可用篩選區段

您可以在 Rapid API 上根據超過 200 個參數進行篩選，包括 top-level 及其子欄位。此清單按字母順序列出目前可用的 top-level 專區。無論是「top-level」欄位及其子欄位，皆可透過 API 進行篩選；未來「top-level」區塊也將支援篩選功能。

address
airports
all_inclusive
amenities
attributes
brand
business_model
catalog
category
chain
checkin
checkout
descriptions
fax
fees
images
location
multi_unit
name
onsite_payments
payment_registration_recommended
phone
policies
property_id
property_ids
rank
rates
ratings
registry_number
rooms
spoken_languages
statistics
supply_source
tax_id
themes
vacation_rental_details

請求範例 2

在此範例中，我們在name 參數中使用了amenities 和include 這兩組值。

curl -X GET "https://test.ean.com/v3/properties/content\
?language=en-US\
&supply_source=expedia\
&include=name\
&include=amenities\
&property_id=1337" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

回應範例 2

此範例顯示，回應中包含了property_id、name 以及amenities。注意：回應中總是會包含 property_id` `；除非您只想取得這個欄位，否則無需在 include 參數中特別指定它。

{
  "1337": {
    "property_id": "1337",
    "name": "Hyatt Regency Paris Etoile",
    "amenities": {
      "8": {
        "id": "8",
        "name": "Elevator"
      },
      "43": {
        "id": "43",
        "name": "Concierge services"
      },
      "115": {
        "id": "115",
        "name": "Bicycle rentals nearby"
      },
      "361": {
        "id": "361",
        "name": "Breakfast available (surcharge)"
      },
      ...
    }
  }
}