검색 및 필터링

신속한 콘텐츠 API 응답을 쉽게 검색하고 필터링하여 보다 타겟팅된 결과를 얻을 수 있습니다.

신속한 콘텐츠 API의 검색 및 필터 기능을 사용하여 응답에서 수신하는 숙박 시설 정보를 제어할 수 있습니다. 이를 통해 수신하는 데이터를 간소화하고 여행자에게 필요한 정보에만 액세스할 수 있으므로 비용이 절감되고 유연성이 향상됩니다.

검색

검색 기능을 사용하여 게스트에게 특정 편의 시설 또는 서비스를 제공하는 숙박 시설(예: 향상된 지속 가능성 기능을 제공하는 숙박 시설)를 찾을 수 있습니다.

다음을 포함하여 property-level 요소로 검색할 수 있습니다:

category_id: 카테고리
all_inclusive: All-inclusive 상태
attribute_id: 속성
amenity_id: #GLSR_DFDHB헤즈 레벨 편의 시설
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및 요청된 섹션으로 구성됩니다.

필터링에 사용 가능한 섹션

top-level 및 하위 필드를 포함하여 Rapid API 에서 200개 이상의 매개변수를 필터링할 수 있습니다. 이 목록에는 현재 사용 가능한 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)"
      },
      ...
    }
  }
}