검색 및 필터링

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

신속한 콘텐츠 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및 요청된 섹션으로 구성됩니다.

필터링에 사용 가능한 섹션

참고: 필터 기능은 향후 추가되는 새로운 top-level 섹션에도 적용되므로 이 목록은 전체 목록으로 간주해서는 안 됩니다.

property_id
name
address
ratings
location
phone
fax
category
rank
business_model
checkin
checkout
fees
policies
attributes
amenities
images
onsite_payments
rooms
rates
dates
descriptions
statistics
airports
themes
all_inclusive
tax_id
chain
brand
spoken_languages
multi_unit
payment_registration_recommended
supply_source
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)"
      },
      ...
    }
  }
}