콘텐츠 API 검색 및 응답 필터링

콘텐츠 API 응답을 쉽게 검색하고 필터링하여 보다 구체적인 결과를 얻을 수 있습니다.

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

검색

고객에게 특정 편의 시설 또는 서비스를 제공하는 숙박 시설을 검색합니다(예: 향상된 지속 가능성 기능을 제공하는 숙박 시설 찾기).

Rapid 파트너는 다음을 포함한 숙박 시설 수준 요소를 기준으로 검색할 수 있습니다.

• category_id - 카테고리
• all_inclusive - 올 인클루시브 상태
• attribute_id - 속성
• amenity_id - 숙박 시설 수준의 편의 시설
• spoken_language_id - 사용 언어

참고: 이 기능에는 특정 객실 또는 요금제 요소가 포함되지 않습니다.

Rapid 3 요청 예시: 이 예에서는 반환되는 숙박 시설을 제한하기 위해 새 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"

Rapid 3 응답 예시: 이 응답에서는 숙박 시설 1에 이용 가능한 편의 시설 ID 115가 없어서 숙박 시설 1337만 반환되는 것을 확인할 수 있습니다.

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

사용 가능한 속성, 편의 시설, 사용 언어 및 카테고리의 전체 목록은 콘텐츠 참조 목록을 참조해 주세요.

필터

전체 숙박 시설 세부 정보를 수신하지 않고 Rapid 콘텐츠 응답의 일부를 요청합니다. 파트너는 필요한 콘텐츠 API 응답의 최상위 섹션만 요청할 수 있습니다. 이는 include 매개변수를 통해 요청할 수 있으며 결과에는 property_id 및 숙박 시설당 요청된 섹션만 포함됩니다.

현재 필터링에 사용 가능한 섹션은 다음과 같습니다.

참고: 필터 기능은 향후 추가되는 새 최상위 섹션에도 적용되므로 이 목록을 완전한 것으로 간주해서는 안 됩니다.

• 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

Rapid 3 요청 예시: 이 예에서는 include 매개변수에 새 값인 name 및 amenities를 사용하고 있습니다.

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"

Rapid 3 응답 예시: 이 응답에서는 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)"
      },
      ...
    }
  }
}