검색 및 필터링

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

이 응답에서 볼 수 있듯이, 숙박 시설 1에는 편의 시설 ID 115가 사용 가능하지 않기 때문에 숙박 시설 1337만 반환됩니다.

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

사용 가능한 속성, 편의 시설, 사용 언어 및 카테고리의 전체 목록은 콘텐츠 참조 목록에서 확인할 수 있습니다.

>> 콘텐츠 참조 목록 보기

필터

숙박 시설의 전체 세부 정보를 받지 않고도, 필요한 top-level 섹션만 요청함으로써 응답의 일부를 받아볼 수 있습니다. include매개변수를 사용하여 원하는 섹션을 지정하십시오. 결과에는 property_id 및 숙박 시설에 명시된 요청된 섹션들이 포함될 것입니다.

필터링 가능한 섹션

Rapid API 에서는 ‘ top-level ’ 및 하위 필드를 포함하여 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)"
      },
      ...
    }
  }
}