검색 및 필터링
신속한 콘텐츠 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)"
},
...
}
}
}