콘텐츠
콘텐츠 API를 사용해 모든 Rapid 숙박 시설에 대한 콘텐츠에 액세스할 수 있습니다.
숙박 시설 콘텐츠
요청된 활성 숙박 시설에 대한 전체 숙박 시설 콘텐츠 또는 숙박 시설 ID 목록을 요청된 언어로 반환합니다.
이 API를 사용하여 검색 조건을 기준으로 전체 숙박 시설 콘텐츠 또는 숙박 시설 ID를 검색할 수 있습니다. 예를 들어, 지난 월요일 이후에 추가된 숙박 시설 목록을 검색하거나 특정 숙박 시설 ID 목록에 대한 숙박 시설 콘텐츠를 검색합니다.
비활성 숙박 시설
때때로 이전에 예약 가능했던 숙박 시설이 닫히고 재고에서 비활성화되는 경우가 있습니다. 비활성 숙박 시설 API로 제공된 전체 날짜 이후 비활성 상태로 된 모든 숙박 시설 목록을 요청해 Rapid에서 판매 또는 예약이 불가능한 숙박 시설을 제외하고 콘텐츠 캐시 또는 스토리지를 업데이트할 수 있습니다.
아래 예시에서 파트너는 5월 31일에 숙박 시설 콘텐츠 API 또는 숙박 시설 콘텐츠 파일 API를 사용해 콘텐츠 캐시나 스토리지의 업데이트를 마지막으로 시도했습니다. 이를 통해 파트너 시스템에서 삭제가 필요한 개체 목록이 property_id와 함께 정렬되지 않은 상태로 표시됩니다. 이 엔드포인트는 숙박 시설 콘텐츠 API 엔드포인트에서 date_added_start, date_added_end, date_updated_start 또는 date_updated_end 중 1개 이상의 매개변수와 함께 사용해 콘텐츠 캐시 또는 스토리지를 계속해서 업데이트할 수 있습니다.
예시:
요청:
https://test.ean.com/v3/properties/inactive?since=2023-06-01응답:
[
{
"property_id": "10003243"
},
{
"property_id": "10012775"
},
{
"property_id": "10013765"
},
{
"property_id": "10017071"
},
{
"property_id": "10041102"
},
{
"property_id": "10042"
},
{
"property_id": "10074774"
},
{
"property_id": "10089905"
},
{
"property_id": "10091055"
},
{
"property_id": "10268276"
},
{
"property_id": "1029882"
},
{
"property_id": "103115"
},
{
"property_id": "10349744"
},
{
"property_id": "10373667"
},
{
"property_id": "1037667"
},
{
"property_id": "1039715"
},
{
"property_id": "10401509"
},
{
"property_id": "104201"
},
{
"property_id": "10465614"
},
{
"property_id": "10484434"
},
{
"property_id": "10488054"
},
{
"property_id": "10520425"
}
]숙박 시설 카탈로그 파일
Rapid의 기본 활성 숙박 시설 목록을 요청된 언어로 다운로드할 수 있는 링크를 반환합니다. 응답에는 각 숙박 시설에 대한 자세한 정보가 포함됩니다.
이 파일을 사용하여 숙박 시설의 전체 목록을 받을 수 있습니다. 숙박 시설 세부 정보는 다른 공급업체의 숙박 시설 목록을 매핑할 때 유용합니다.
숙박 시설 콘텐츠 파일
Rapid의 활성 숙박 시설 전체에 대한 모든 콘텐츠를 요청된 언어로 다운로드할 수 있는 링크를 반환합니다. 응답에는 숙박 시설 수준, 객실 수준 및 요금 수준 정보가 포함됩니다.
이 파일을 사용하여 모든 숙박 시설의 콘텐츠를 전부 검색할 수 있습니다. 숙박 시설의 하위 집합만 필요한 경우에는 숙박 시설 콘텐츠 API를 대신 사용합니다.
체인 참고 사항
Rapid에서 인식된 전체 체인 집합을 반환합니다.
체인은 연관된 여러 브랜드를 포함할 수 있는 모회사를 나타냅니다.
브랜드는 하나의 모 체인에만 속할 수 있습니다. 예를 들어, Hilton Worldwide는 DoubleTree, Hampton Inn, Embassy Suites를 포함한 여러 브랜드를 거느린 체인입니다.
추가 참조 정보
현지화
language매개변수는 하이픈으로 연결된 두 자리 언어 및 국가 코드 쌍만 사용합니다. 코드를 통합하기 전에 여기에서 지원되는 모든 언어를 확인해 주세요.
숙박 시설 등급
Rapid 콘텐츠 API에 환원된 숙박 시설 등급은 여행객에게 가구, 서비스, 편의 시설 측면에서 일반적으로 숙박 시설에서 기대할 수 있는 사항에 대한 지침을 제공합니다. 숙박 시설 등급의 적용 방식에 대한 자세한 내용은 여기를 참조해 주세요.
참조 목록
Rapid 콘텐츠 API에서 제공되는 숙박 시설 정보는 보통 ID로 표시됩니다. 참조 목록을 살펴보며 ID의 의미를 이해할 수 있습니다. 참조 목록은 영어로만 제공되지만, API에서는 현지화된 이름이 반환됩니다.
등록 번호
Rapid 콘텐츠 API의 registry_number 매개변수는 단일 또는 여러 등록 세부 정보를 반환합니다. 이러한 세부 정보에는 국가별로 필요에 따라 단어, 문자, 숫자 및 특수 문자가 포함될 수 있습니다. 저희는 숙박 시설이 현지 법률 및 규정 표시 요건을 준수할 수 있도록 이러한 번호를 제공합니다.
예시:
"registry_number": "Property Registration Number 004071AAA-00004, IT005748GHFMUHG",
"registry_number": "IT00574-8GHFMUHG",재고 관련 기회
EPS 포털의 재고 관련 기회 페이지에서는 Rapid API와의 통합을 위해 관련된 매핑되지 않은 숙박 시설 목록을 제공합니다. 공급되는 숙박 시설은 자주 변경되므로 파트너는 이러한 숙박 시설을 정기적으로 검토하여 추가하거나 다른 공급업체의 숙박 시설에 매핑해야 합니다. 그래야만 여행객이 파트너의 웹사이트에서 중복된 숙박 시설을 보거나 새로운 숙박 시설을 놓치는 일이 없습니다.
API 세부 정보
이 페이지에서 콘텐츠 관련 엔드포인트 정의를 살펴본 후 API Explorer 또는 다른 테스트 소프트웨어를 사용하여 예시 및 스키마 정의가 실제 출력과 어떤 차이가 있는지 확인해 보세요.
추가 리소스
모든 Rapid API 엔드포인트를 사용해 보거나 OpenAPI 사양 또는 Postman 컬렉션을 다운로드하려는 경우 다음 사항을 참조해 주세요.