위치별 호텔 목록 또는 특정 hotelIds 목록을 검색합니다.

이 방법은 제공된 날짜 범위에 예약 가능 객실을 보유한 호텔을 반환하거나 예약 가능 객실과 상관없이 지정된 위치 내의 모든 활성 숙박 시설 목록을 반환할 때 사용할 수 있습니다.

이 방법에서는 원하는 위치를 지정하는 여러 개의 필터와 방법을 지원하여 다양한 프론트 엔드 검색 옵션(예: 공항 코드 또는 지도의 시각화별 검색)을 허용합니다.

요청 형식
XML/REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/list?
XML 상위 요소: <HotelListRequest>

고유 프로토콜 요구 사항
REST
  • 객실 및 투숙객 수는 XML과 형식이 다릅니다. 이 페이지에서 REST 객실 형식 섹션을 참조하세요.

요청 매개변수
예약 가능한 호텔을 검색하려면 최소 날짜 범위, 객실 수, 성인 투숙객 수, 위치 또는 hotelId 목록이 필요합니다.

예약 가능 객실과 상관없이 위치 내의 "날짜가 없는 목록" 또는 모든 활성 숙박 시설 목록을 얻으려면 요청에서 arrivalDate, departureDateRoomGroup 매개변수를 생략하면 됩니다.

기본 요인
이름 필수 설명
apiExperience 문자열 필수

이 속성을 사용하여 요청의 원본을 식별할 수 있습니다. 제출한 각 요청의 아래에 제시된 집합에서 해당 값을 선택합니다.

값:
PARTNER_CALL_CENTER - 콜센터 담당자 요청
PARTNER_WEBSITE - 고객용 웹 사이트 요청
PARTNER_MOBILE_WEB - 모바일 형식 웹 사이트 요청
PARTNER_MOBILE_APP - 모바일 앱 요청
PARTNER_BOT_CACHE - 캐시 봇 요청
PARTNER_BOT_REPORTING - 보고 봇 요청
PARTNER_AFFILIATE - 고유 제휴사 기반으로 서비스하는 API/플랫폼 요청

arrivalDate 문자열 예약 가능 객실에 대해 필수

체크인 날짜, MM/DD/YYYY 형식입니다.

당일 이용 요청을 위한 오늘 날짜를 포함합니다. 예약은 현지 호텔 시간으로 오후 11시 59분까지 가능합니다(PST 및 태평양제도의 경우 오후 9시 59분).

departureDate 문자열 예약 가능 객실에 대해 필수 MM/DD/YYYY 형식의 체크아웃 날짜입니다.

예약 가능 여부는 이 날짜에서 500일 전부터 검색할 수 있습니다.

총 숙박 일수는 28일보다 클 수 없습니다.
numberOfResults 정수 필수 아님 응답당 반환할 수 있는 최대 호텔 수입니다(추가 결과에 대한 페이지 앞). 적용 가능한 값 범위는 1 - 200입니다. 기본값: 20

날짜가 없는 목록 요청의 결과를 제한하지 않습니다.
RoomGroup 개체 예약 가능 객실에 대해 필수 투숙객 및 객실 수를 정의하는 Room 배열의 컨테이너입니다. REST의 경우 아래 섹션을 참조하십시오.
RoomGroup.Room 배열 예약 가능 객실에 대해 필수 요청된 객실 수를 정의하는 Room 노드의 개수입니다. 각 노드에는 성인/아동 투숙객 수가 포함됩니다.

예약당 최대 8개의 객실까지 허용됩니다.
Room.numberOfAdults 정수 예약 가능 객실에 대해 필수 객실의 성인 투숙객 수입니다.

일반적으로 인당 추가 요금 없이 투숙객 4인까지 수용합니다.

객실당 8명 이상의 투숙객을 허용하지 마십시오. 대부분의 시장에서는 8명 이상의 투숙객에 대한 결과가 반환되지 않습니다.
Room.numberOfChildren 정수 > 0인 경우 필수 객실의 아동 투숙객 수입니다. 모든 요청에 대해 필수입니다. childAges와 조합되어 예약 가능 객실 및 요금이 결정됩니다.
Room.childAges 쉼표로 구분된
목록 또는 정수 배열
아동 수가 > 0인 경우 필수 객실에 투숙하는 아동의 개별 연령을 쉼표로 구분된 목록(XML 또는 REST)과 childAges의 개별 값 배열(SOAP)로 전송합니다.

아동 투숙객이 지정된 경우 항상 이 정보를 고객에게 필수로 요청하십시오. 예약 전에 아동의 연령을 밝히지 않으면 예기치 않은 추가 인원 비용이 발생할 수 있습니다.
includeDetails 부울 필수 아님

객실별 취소 정책, 침대 유형, 흡연/비흡연(사용 가능한 경우)을 반환합니다.

minorRev=22 이상일 경우에만 추가 요소를 반환합니다.

includeHotelFeeBreakdown 부울 필수 아님 각 요금의 적용 빈도와 적용 방식을 포함하여 HotelFees 배열에 대한 더욱 자세한 응답 구조를 포함하는 HotelFeeBreakdown 요소를 반환합니다. minorRev=24 이상에서 사용 가능합니다.
REST 객실 형식
REST 형식은 이전 요소 값을 쉼표로 구분된 목록으로 압축합니다. 객실 및 투숙 인원을 명시하려면 다음 형식을 사용하시기 바랍니다.

&room[객실 번호, 1부터 시작]=
[성인 수],
[쉼표로 구분된 아동 연령 목록]


예를 들어 성인 1명과 각각 5세, 12세의 아동 2명이 있는 객실의 경우 다음과 같이 전송합니다. &room1=1,5,12 . 아동 수를 개별적으로 명시하지 않으면 한 명의 아동이 각 연령에 해당하는 것으로 간주됩니다.


기본 검색 방법
요청에 대한 응답에 포함되는 선택된 호텔 개수를 제한하기 위한 방법에는 네 가지가 있습니다. 이는 특별한 순서 없이 아래에 제시되어 있습니다.
그중 세 가지 방법은 지정된 위치에 의해 선택이 제한되며, 나머지 한 가지 방법은 특정 hotelIds 목록을 통해 명시된 호텔 집합이 반환됩니다.
한 번에 한 가지 방법만 사용하십시오.


방법 1: 시/도/국가 검색
이름 검색 방법에 필수 설명
city 문자열 필수
검색 대상 도시이며 전체 도시 이름만 사용합니다.
stateProvinceCode 문자열 US,
CA, AU에 대해 필수
시/도를 나타내는 두 자리의 코드로, 지정된 도시를 포함합니다. 호주의 경우 아래의 특수 코드를 사용해야 합니다.

참조:
미국 주 코드
캐나다 주/준주 코드
오스트레일리아 주/준주 코드
  • 오스트레일리아 수도 - AC
  • 뉴사우스웨일즈 - NW
  • 노던 주 - NO
  • 퀸즈랜드 - QL
  • 사우스오스트레일리아 - SA
  • 태즈메이니아 - TS
  • 빅토리아 - VC
  • 웨스턴 오스트레일리아 - WT
countryCode 문자열 필수
국가를 나타내는 두 자리의 ISO-3166 코드이며 지정된 도시를 포함합니다. ISO-3166 디코딩 표에 "공식적으로 지정"된 국가 코드만 사용합니다.


방법 2: 자유 텍스트 대상 문자열 사용
이름 검색 방법에 필수 설명
destinationString 문자열 필수 최소 1개의 도시 이름을 포함한 문자열입니다. 도시 및 주, 도시 및 국가, 도시/주/국가 등도 보낼 수 있습니다.

이 매개변수는 직접 고객 입력을 받는 경우 사용할 수 있는 가장 좋은 옵션입니다.

불분명한 항목 입력 시 의도된 위치 목록을 포함하는 오류가 반환됩니다.


방법 3: hotelIds 목록 사용
이름 검색 방법에 필수 설명
hotelIdList 쉼표로 구분된
정수(Long) 목록
필수 일련의 확정된 호텔에 대한 예약 가능 객실을 확인합니다. 필요한 hotelId 값을 쉼표로 구분된 목록으로 전송합니다.

정렬 순서가 명시되지 않은 경우 EAN의 기본 최적화 알고리즘에 따라 호텔이 정렬됩니다. 목록의 순서를 유지하려면 NO_SORT 정렬 옵션을 사용하십시오.

유효하지 않은 hotelId 값은 응답 헤더 Invalid-Hotel-Ids 밑에 쉼표로 구분된 목록으로 반환됩니다.
Vary: Accept-Encoding 
Content-Length: 1562
Avail-Source: 1
Invalid-Hotel-Ids: 1234,6645353
Transaction-Id: d85a243e-b61d-11e5-a89b-0b34b1565000
정수(Long) 목록을 사용하면 여러 요청 전반에서 작은 목록에 비해 응답 시간이 현저하게 길어질 수 있습니다. REST를 통해 정수(Long) 목록을 보낼 때는 GET 대신 POST를 사용하십시오. 절대적인 제한값은 요청당 2500개의 호텔 ID입니다.


방법 4: 특정 지역에서 검색
이름 검색 방법에 필수 설명
latitude 문자열 필수 검색의 원점에 대한 위도 좌표이며 DD.MMmmm 형식입니다.
longitude 문자열 필수 검색의 원점에 대한 경도 좌표이며 DDD.MMmmm 형식입니다.
searchRadius 정수 필수 아님 센터를 정의하는 제공된 latitudelongitude 값을 사용하여 원형 검색 영역의 반경을 정의합니다.
최소 1 MI 또는 2 KM, 최대 50 MI 또는 80 KM. 최대치를 넘는 값은 결과가 반환되기 전에 자동으로 감소합니다.
기본값: 20 MI.
searchRadiusUnit 문자열 필수 아님 검색 반경의 거리 단위를 설정합니다. 다음을 전송합니다.
MI 또는 KM. 비어 있거나 포함되지 않은 경우 기본값은 MI입니다.
sort 문자열 필수 아님 원점에서 떨어진 거리에 따라 결과를 정렬하려면 PROXIMITY 값을 전송해야 합니다. 그렇지 않으면 검색 반경 내에 해당하는 모든 호텔에 기본 정렬 순서가 적용됩니다.

사용 가능한 모든 값은 다음 섹션의 요소 전체 정의를 참조하십시오.

날짜가 없는 목록 요청의 결과에는 적용되지 않습니다.
추가 검색 방법
다음 검색 방법을 추가 옵션으로 제공하여 고객이 근처의 주소나 특정 호텔을 통해 검색할 수 있도록 허용합니다.


이름 기타 요인 필요 설명
address 문자열 필수 인근의 현지 상세 주소로 검색합니다. 응답에는 각 숙박업소와 주어진 주소 간의 거리가 포함됩니다.

특정 호텔의 주소를 입력한 경우에도 해당 주소가 맨 위에 위치하지 않는다면 기본 정렬 순서의 위치가 재지정되지 않습니다.

citycountryCode 매개변수를 정의해야 합니다.
postalCode 문자열 필수 주소의 우편 번호를 선택적으로 포함합니다.

citycountryCode 매개변수를 정의해야 합니다.
propertyName 문자열 필수 예약 가능 객실을 검색할 이름입니다. 값은 정확한 이름이거나 이름의 일부일 수 있습니다(예: "휴가" 또는 "베스트)."

응답에는 이 요인에 속하는 값이 포함된 이름을 가진 모든 숙박업소가 포함됩니다.

특정 숙박업소의 이름이 전송되고 주어진 숙박 기간에 예약 가능 객실이 없는 경우 빈 응답이 반환됩니다.

citycountryCode 매개변수를 정의해야 합니다.

필터링 방법
여기에 해당하는 방법은 편의 시설, 요금, 호텔 등급 및 그 외 쇼핑 기준에 따라 결과를 필터링합니다. 이러한 방법은 기본 방법과 함께 초기 검색 전에 제공되거나 기존 검색 결과 페이지를 동적으로 업데이트하는 데 사용할 수 있습니다. 또한 고객에게 제공되는 결과를 제한하는 데 내부적으로 사용할 수 있습니다. 예를 들어 숙박 시설 검색 범위를 특정 성급 수준 이상으로 제한할 수 있습니다.

이름 필수 설명
includeSurrounding 부울 필수 아님 이 매개변수를 false로 보내면 검색 매개변수에 정의된 지역 밖의 호텔이 배제됩니다.
다른 근처 도시 또는 외부의 호텔이 결과에 표시되지 않도록 하려면 사용하십시오.
propertyCategory 정수 또는 쉼표로 구분된 정수 목록 필수 아님

숙박업소 범주에 따라 결과를 필터링합니다. 단일 값 또는 값 목록을 전송하여 숙박업소 범주의 조합을 반환할 수 있습니다.

참고:
이러한 값은 정적 데이터베이스 파일 또는 다른 Expedia 제공 데이터의 분류와 일치하지 않습니다.

값:
1: 호텔
2: 스위트
3: 리조트
4: 휴가철 렌트/콘도
5: B&B
6: 올 인클루시브

amenities 정수 또는 쉼표로 구분된 정수 목록 필수 아님

이 요소는 더 이상 사용을 권장하지 않습니다. 이 요소에 대한 값이 Expedia의 편의 시설 및 자체 편의 시설 데이터베이스 파일과 일치하지 않습니다.
권장되는 해결 방법은 AttributeList 데이터베이스 파일을 로컬로 다운로드하고 이것을 사용하여 요청 위치에 있는 호텔과 필터링된 편의 시설이 있는 호텔을 모두 필터링하십시오.

maxStarRating 부동 필수 아님 최대 호텔 등급별로 결과를 필터링합니다.
유효한 값은 1.0에서 5.0까지 0.5 단위로 증가하는 값입니다.
minStarRating 부동 필수 아님 최소 호텔 등급별로 결과를 필터링합니다.
유효한 값은 1.0에서 5.0까지 0.5 단위로 증가하는 값입니다.
minRate 부동 필수 아님 요금이 입력한 값 이상인 숙박업소별로 결과를 필터링합니다.
averageRate 응답 값(투숙 기간 중 1박당 평균 객실 요금)에 따라 검색합니다. 예약 가능 객실 검색에만 유효합니다.
maxRate 부동 필수 아님 요금이 입력한 값 이하인 숙박업소별로 결과를 필터링합니다.
averageRate 응답 값(투숙 기간 중 1박당 평균 객실 요금)에 따라 검색합니다. 예약 가능 객실 검색에만 유효합니다.
numberOfBedRooms 정수 필수 아님 이 요인은 콘도/휴가철 렌트에만 유효합니다. 요청된 침실의 수를 지정하며 최대 4개까지 가능합니다.
maxRatePlanCount 정수 필수 아님 각 숙박업소와 반환할 객실 유형의 개수를 정의합니다.

높은 값을 설정하면 개별 숙박 시설의 예약 가능 객실에 따라 응답에서 각 숙박 시설에 해당하는 객실 유형 수를 반환하려고 합니다.

기본값은 1이며 각 숙박 시설의 첫 번째 객실 유형만 반환됩니다. Expedia 사용자 테스트에 따르면 이 값은 최고의 전환율을 제공하는 것으로 입증되었습니다. 객실 선택 단계에서 객실이 추가로 표시되지 않도록 있는 그대로 사용하는 것이 좋습니다.

정렬 옵션
기본 정렬 순서는 가장 선호되며 최적의 전환율을 보이는 숙박 시설이 상위에 배치하도록 계산되기 때문에 지정된 정렬 순서 없이 초기 검색을 전송하는 것이 좋습니다. 대신 초기 목록을 반환한 다음 고객이 다른 정렬 순서를 선택하도록 허용하세요.
이름 필수 설명
sort 문자열 필수 아님 반환된 숙박업소의 정렬 기본 설정입니다.

값:
DEFAULT

정렬은 수익성에 맞게 최적화되어 있습니다.

BUDGET

각 시장의 저가 호텔에 우선 순위가 적용되어 수익성 순으로 정렬됩니다. 조회에서 예약까지의 수익성 비율이 가장 높은 저가 호텔이 최상단에 배치됩니다.

CHAMPION

각 시장의 중간급 호텔에 우선 순위가 적용되어 수익성 순으로 정렬됩니다. 조회에서 예약까지의 수익성 비율이 가장 높은 중간급 호텔이 최상단에 배치됩니다.

PREMIUM

각 시장의 고급 호텔에 우선 순위가 적용되어 수익성 순으로 정렬됩니다. 조회에서 예약까지의 수익성 비율이 가장 높은 고급 호텔이 최상단에 배치됩니다.

PROMO 프로모션 요금 또는 부가 서비스를 제공하는 숙박업소를 그렇지 않은 숙박업소보다 상위에 배치합니다.
PRICE_AVERAGE 평균 숙박비(오름차순) 별로 숙박 시설을 정렬합니다. 순서는 API에서 접속하는 숙박업소 목록에 적용되는 비즈니스/마케팅 사무 알고리즘으로 인해 완벽하지 않을 수 있습니다. 정확한 요금 정렬은 결과를 수신한 뒤 자체 코드 내에서 이루어집니다.
PRICE_REVERSE 숙박비(내림차순)별로 숙박업소를 정렬합니다. 위에서 설명한 것처럼 정렬이 완벽하지 않을 수 있습니다.
QUALITY 호텔 등급(내림차순)별로 숙박업소를 정렬합니다.
QUALITY_REVERSE 호텔 등급(오름차순)별로 숙박업소를 정렬합니다.
PROXIMITY latitude & longitude 매개변수에 따라 정의된 원점과의 거리에 따라 정렬합니다.
TRIP_ADVISOR 승인된 TripAdvisor 통합이 있는 경우 이 값은 결과를 투숙객 평점이 높은 것부터 낮은 것 순서로 정렬합니다.
NO_SORT hotelIdList와만 함께 사용됩니다. 요청에 나열된 정확한 순서에 따라 호텔을 반환합니다.
HIGH_MARGIN

CHAMPION 정렬에 따라 HIGH_MARGIN 정렬이 한 단계 올라가 수익 백분율이 가장 높은 숙박 시설에 우선 순위가 부여됩니다. 따라서 전환율과 수익성이 높은 호텔이 상단에 배치됩니다. HIGH_MARGIN 정렬은 숙박 시설의 추가 비용을 고려하여 파트너의 수익 백분율에 우선 순위를 둡니다.

추가 데이터 요청

이 매개변수를 사용하여 동적 데이터의 특정 유형에 대한 응답을 제한할 수 있습니다. 일반적으로 API에서 제공하는 정적 정보의 소스로, 주로호텔 데이터베이스 파일과 함께 사용됩니다. 오프라인 데이터베이스와 함께 이 요인을 통합하여 사용하면 API 응답에 전적으로 의존하는 것보다 응답 시간이 훨씬 빨라집니다.

이름 필수 설명
options 문자열 또는 쉼표로 구분된
문자열 목록
필수 아님 반환할 제한된 데이터 유형을 정의합니다. 단일 값 또는 쉼표로 구분된 목록 조합을 전송합니다.

값:
DEFAULT 아래의 3가지 데이터 유형을 반환합니다. options가 완전히 생략된 것처럼 동일한 응답이 반환됩니다.
HOTEL_SUMMARY

적은 분량의 정적 식별 정보(호텔 이름과 주소, 위치 설명, hotelId 등)와 함께 동적 호텔 정보를 반환합니다.
동적 요금 정보를 포함하지 않습니다. 가장 간단한 예약 가능 객실 응답입니다.

ROOM_RATE_DETAILS hotelIdroomDescription에 따라 동적 객실 요금 정보 및 최소한의 정적 정보를 반환합니다.
추가 호텔 결과를 위한 페이징

최초 응답이 moreResultsAvailabletrue로 반환하는 경우 아래 절차에 따라 다음 페이지의 결과를 요청할 수 있습니다.

추가 결과를 위해 페이징하는 경우, 이후 예약 가능 객실 요청에 supplierType, cacheLocationcacheKey만 전송될 수 있습니다. 그 외 일반적이지 않은 모든 요인은 생략해야 합니다.

요청에 값 supplierType=E를 포함해야 합니다. 이 값을 포함하지 않는 경우 moreResultsAvailable은 목록이 모두 사용되면 true를 잘못 반환할 수 있습니다.

마지막으로 오류 메시지가 "cacheLocation cannot be found"를 반환하는 경우 캐시가 만료되었으며 원래 검색을 다시 요청해야 합니다. 캐시된 응답은 일반적으로 15분~30분 정도 활성화됩니다.

예시를 확인하려면 추가 결과를 위한 페이징을 참조하십시오.


이름 유형 방법에 필수 설명
supplierType 문자열 필수 페이징 시스템이 추가 결과를 정확히 나타낼 수 있으려면 반드시E와 함께 보내야 합니다.
cacheKey 문자열 필수 요청된 특정 캐시 응답에 대한 키입니다. 이전 호텔 목록 응답에서 반환된 값을 사용합니다.
cacheLocation 문자열 필수 요청된 캐시의 EAN 서버 위치를 정의합니다. 이전 호텔 목록 응답에서 반환된 값을 사용합니다.
호텔 목록 응답
제공된 숙박객 수 및 숙박 날짜에 예약 가능 객실을 보유한 지정된 위치 내의 호텔을 반환합니다.

"날짜가 없는 목록"이 arrivalDate, departureDateRoomGroup을 생략하여 요청된 경우, 응답에는 예약 가능 객실에 대한 정보 없이 지정된 위치 내의 모든 활성 호텔이 포함됩니다.

응답 컨텐츠
상위 요소: HotelListResponse


이름 설명
moreResultsAvailable 부울 페이징할 수 있는 추가 숙박업소 결과가 있는지 나타냅니다.

true인 경우 페이징 프로세스를 통해 추가 결과를 얻을 수 있습니다.
numberOfRoomsRequested 정수 원래 요청된 객실의 수(Room 노드의 수)를 확인합니다.
cacheKey 문자열 반환된 현재 응답의 캐시에 대한 키입니다. 다음 페이징 요청에서 이 값을 사용합니다.
cacheLocation 문자열 반환된 현재 응답에 대한 캐시의 EAN 서버 위치를 정의합니다. 다음 페이징 요청에서 이 값을 사용합니다.
HotelList HotelSummary 배열의 컨테이너

응답에서 개별 숙박업소의 개수를 나타내는 size 특성, 지정된 위치 내의 활성화된 숙박업소의 총 개수를 나타내는 activePropertyCount 특성(필수 아님)을 포함합니다.

HotelList.HotelSummary 개체 개별 호텔의 배열입니다. 각 호텔 결과에 대한 정보는 자체 HotelSummary 노드에 포함되어 있습니다.
각 호텔의 원래 번호 순서를 나타내어 동적 재정렬(1이 아닌 0부터 시작하는 시퀀스)로부터 복구할 수 있는 order 특성을 포함합니다.
HotelSummary.hotelId 정수(Long) 숙박업소에 대한 ID입니다. 동일한 ID가 이후의 모든 객실 또는 예약 요청에 사용됩니다.
HotelSummary.name 문자열 호텔 이름
HotelSummary.address1 문자열 호텔 위치 주소
HotelSummary.city 문자열 호텔이 위치한 도시
HotelSummary.stateProvinceCode 문자열 시/도를 나타내는 두 자리의 코드로, 지정된 도시를 포함합니다. 미국, 캐나다 및 호주 국가 코드인 경우에만 반환됩니다.

참조:
미국 주 코드
캐나다 주/준주 코드
오스트레일리아 주/준주 코드
HotelSummary.countryCode 문자열 호텔이 위치한 국가를 나타내는 두 자리의 ISO-3166 코드입니다.
HotelSummary.postalCode 문자열 호텔의 우편 번호
HotelSummary.airportCode 문자열 호텔과 연결된 공항 코드
HotelSummary.supplierType 문자열 호텔 공급업체입니다. 제공된 모든 예약을 처리할 때 동일한 공급업체가 사용됩니다.

값:
E: Expedia Collect
HotelSummary.propertyCategory 문자열 반환된 숙박업소의 범주입니다.

값:
1: 호텔
2: 스위트
3: 리조트
4: 휴가철 렌트/콘도
5: B&B
6: 올 인클루시브
HotelSummary.hotelRating 부동 호텔 등급(0-5)입니다. 0.0 값 또는 빈 값은 해당하는 호텔이 없음을 나타냅니다.
HotelSummary.hotelRatingDisplay 문자열 hotelRating 값에 대한 소스 및 필요한 표시 유형을 나타내는 Star 또는 Alternate를 반환합니다.

현재, 오스트레일리아의 유일한 판매 장소는 제공된 표시기를 따라야 합니다. 이후에 다른 지역이 추가될 예정입니다.

Star는 호텔의 현지 호텔 등급 기관에서 등급이 제공되고 있음을 나타냅니다. 스타를 사용하여 hotelRating을 표시합니다.

AlternatehotelRating이 Expedia에서 할당된 값으로, 공식 등급을 사용할 수 없음을 나타냅니다. 대체 표시(예: 원 또는 사각형)를 사용하여 현지 당국의 공식 등급이 아님을 나타내세요.

minorRev=30 이상에 대해서만 반환됩니다.
HotelSummary.shortDescription 문자열 숙박업소에서 입력한 간단한 설명 텍스트입니다. 200자를 초과하는 항목은 잘립니다.
성능을 높이려면 이 값 끝에 생략 부호(…)를 추가하고 숙박업소의 예약 가능 객실 페이지로 연결되도록 설정하십시오.
HotelSummary.locationDescription 문자열 숙박업소에서 입력한 일반적인 위치(예: "파이크 플레이스 마켓 근처")입니다."
HotelSummary.lowRate 문자열 호텔에서 최근 쿼리에 반환한 최저 요금입니다. 이것은 통계 수치이며 현재 예약 가능 객실에 대한 요금이 아닐 수 있습니다.
이 값은 항상 USD로 반환됩니다.
HotelSummary.highRate 문자열 호텔에서 최근 쿼리에 반환한 최고 요금입니다. 이것은 통계 수치이며 현재 예약 가능 객실에 대한 요금이 아닐 수 있습니다.
이 값은 항상 USD로 반환됩니다.
HotelSummary.rateCurrencyCode 문자열 반환된 높은 또는 낮은 요금의 통화 코드입니다.
HotelSummary.latitude 부동 호텔의 위도 좌표입니다.
HotelSummary.longitude 부동 호텔의 경도 좌표입니다.
HotelSummary.proximityDistance 부동 해당 검색 방법이 사용된 경우 원래 지정된 좌표와 호텔 간의 거리입니다.
HotelSummary.proximityUnit 문자열 proximityDistance에서 제공된 거리 단위입니다. MI 또는 KM.
HotelSummary.hotelInDestination 부울 숙박업소가 원래 지정된 도시 또는 확장 영역 내(예: 대도시 또는 그 외 인근 도시)에 있는지 여부를 나타냅니다.

지정된 도시 외부의 호텔은 원래 지역으로부터의 거리를 기준으로 그룹화됩니다(예: 10마일 내, 20마일 내 등).
HotelSummary.thumbNailUrl 문자열 입력된 경우 숙박업소의 축소판 이미지의 URL 경로입니다.

전체 URL은 반환되지 않음 - CNAME를 origin-images.travelnow.com에서 목적지로 설정하여 이 값을 http://images.travelnow.com 또는 자체 이미지 하위 도메인에 첨부합니다. SSL을 사용하는 HTTPS가 지원됩니다.
문자열 템플릿에 호텔 페이지에 상응하는 딥 링크를 추가합니다. 반환 형식은 기존의 템플릿 계정과 호환됩니다.
HotelSummary.RoomRateDetailsList RoomRate
Details
배열의 컨테이너
컨테이너만 해당, 특성 없음 모든 객실별 요소 데이터를 보유합니다.
RoomRateDetailsList.RoomRateDetails 배열 호텔에서 반환한 첫 번째 객실의 세부정보를 포함합니다. maxRatePlanCount 값이 >1인 경우 반환된 모든 추가 객실에 대한 추가 노드입니다.
RoomRateDetails.roomTypeCode 문자열 객실에 대한 객실 유형 코드입니다.
RoomRateDetails.rateCode 문자열 표시된 요금에 대한 코드입니다.
RoomRateDetails.maxRoomOccupancy 정수 추가 요금이 발생될 수 있는 고객을 포함하여 객실 수용 가능 최대 인원을 나타냅니다.
RoomRateDetails.quotedRoomOccupancy 정수 추가 요금을 제외한 객실 수용 가능 최대 인원을 나타냅니다.
RoomRateDetails.minGuestAge 정수 객실에 허용된 투숙객 최소 연령입니다.
RoomRateDetails.roomDescription 문자열 반환된 roomTypeCode와 연관된 객실 설명입니다.
RoomRateDetails.promoId 문자열 반환된 프로모션 상품의 ID입니다(있는 경우). REST에서 이 값은 정수로 반환됩니다.
RoomRateDetails.promoDescription 문자열 반환된 프로모션의 설명입니다(있는 경우). 최대 255자가 반환됩니다.
RoomRateDetails.promoDetailText 문자열 반환된 프로모션의 추가 세부정보입니다(있는 경우).
RoomRateDetails.currentAllotment 정수 숙박업소에서 보유하고 있는 예약 가능한 객실 수입니다. 이 값을 사용하여 긴급 메시지에 대한 규칙을 생성하면 성수기나 인기 숙박업소에 대해 예약 가능 객실 수가 적음을 사용자에게 알려 줄 수 있습니다.

0이 반환되는 경우에도 숙박업소에 예약 가능한 객실이 부족하다는 뜻이 아닙니다. 이것은 값을 계산하는 데 필요한 규칙이 충족되지 않음을 나타내며 절대적인 예약 가능 객실을 나타내는 것이 아닙니다.
RoomRateDetails.propertyAvailable 부울 내부 재고 참조용입니다.
표준 요청 시 예약 가능한 재고만 반환합니다.
RoomRateDetails.propertyRestricted 부울 내부 재고 참조용입니다. 특정 제한사항은 취소 정책을 참조하십시오.
RoomRateDetails.expediaPropertyId 문자열 호텔의 Expedia ID입니다. Expedia로 상호 참조할 때 이 값을 사용하여 hotelId에 매핑합니다.
RoomRateDetails.BedTypes 배열 각 객실의 침대 유형 선택권입니다. 싱글 침대 유형이나 예약할 때 포함할 수 있는 선택권을 반환할 수 있습니다. 침대 유형에 대한 세부정보 검토
minorRev=22 이상에서 사용 가능합니다. 요청에서 includeDetails=true가 전송된 경우에만 반환됩니다.
RoomRateDetails.smokingPreferences 쉼표로 구분된 문자열 목록 객실에 대해 흡연/비흡연을 사용 가능합니다(해당하는 경우).

값:
NS: 금연
S: 흡연
E: 상관없음

minorRev=22 이상에서 사용 가능합니다. 요청에서 includeDetails=true가 전송된 경우에만 반환됩니다.
RoomRateDetails.ValueAdds 다음에 대한 컨테이너: ValueAdd 해당하는 경우 제공된 객실 및 요금에 대한 ValueAdd 요소의 배열을 포함합니다. 반환된 부가 서비스의 개수를 나타내기 위해 size 특성을 포함합니다.
ValueAdds.ValueAdd 배열

제공된 객실 및 요금에 포함되는 무료 서비스(예: 무료 아침식사 또는 무선 인터넷)에 대해 description 요소를 포함합니다.

minorRev=2829의 경우 숫자로 된 id 특성은 반환되지 않고 description만 제공됩니다.

minorRev=30의 경우 숫자로 된 id 특성이 26 이하로 반환된 서로 다른 값 집합과 함께 반환됩니다. 두 값 세트는 모두 부가 서비스 참조 페이지에서 확인할 수 있습니다.

RoomRateDetails.RateInfos 다음에 대한 컨테이너: RateInfo 개별 객실에 대해 상세 요금 정보를 제공하는 RateInfo 요소의 배열을 포함합니다.

또는 minorRev=6 이하에서 실행되는 오래된 통합을 사용하는 경우 RateInfoRateInfos 컨테이너 없이 반환됩니다.

RateInfos.RateInfo 개체 몇 가지 다른 개체 및 개별 값 내에서 단일 객실에 대한 모든 요금 정보를 포함합니다.

특성:
priceBreakdown부울 청구된 전체 요금 내역에 세금과 총금액이 포함되어 있는지 나타냅니다.
promo 부울 반환된 요금이 프로모션 요금인지 나타냅니다.
rateChange 부울 투숙 기간 동안 하루 이상의 숙박비가 다른 날과 다른지 나타냅니다.
RateInfo.promoId 문자열 반환된 프로모션 상품의 ID입니다(있는 경우).
RateInfo.promoDescription 문자열 반환된 프로모션의 설명입니다(있는 경우). 최대 255자가 반환됩니다.
RateInfo.promoDetailText 문자열 반환된 프로모션의 추가 세부정보입니다(있는 경우).
RateInfo.currentAllotment 정수 숙박업소에서 보유하고 있는 예약 가능한 객실 수입니다. 이 값을 사용하여 긴급 메시지에 대한 규칙을 생성하면 성수기나 인기 숙박업소에 대해 예약 가능 객실 수가 적음을 사용자에게 알려 줄 수 있습니다.

0이 반환되는 경우에도 숙박업소에 예약 가능한 객실이 부족하다는 뜻이 아닙니다. 이것은 값을 계산하는 데 필요한 규칙이 충족되지 않음을 나타내며 절대적인 예약 가능 객실을 나타내는 것이 아닙니다.
RateInfo.cancellationPolicy 문자열 이 객실에 대한 호텔의 취소 정책입니다. 모든 예약 및 예약 확인 페이지뿐만 아니라 개별 객실 페이지에도 표시해야 합니다.
요청에서 includeDetails=true가 전송된 경우에만 반환됩니다.
RateInfo.CancelPolicyInfoList Cancel
PolicyInfo에 대한 컨테이너
취소 정책의 구체적인 내용은 일반적으로 위약금 부과 기간을 결정하는 시간과 취소 시 발생하는 위약금입니다.
요청에서 includeDetails=true가 전송된 경우에만 반환됩니다.
RateInfo.rateType 문자열 반환 요금이 EAN을 통해 선납되는지 호텔에서 후납되는지 여부를 표시합니다. 선불 예약 가능 객실에 대해 MerchantStandard의 값으로 반환되거나 모든 후불에 대해 반환되지 않습니다.
RateInfo.nonRefundable 부울 예약 후에 환불 가능 여부를 명시적으로 나타냅니다. 반환된 취소 정책도 제시해야 합니다. 이 값은 기타 정책 데이터에 언제나 우선합니다.
예약 가능성만 반환됩니다.
RateInfo.promoType 문자열 반환된 프로모션이 모바일용인지 표준 프로모션인지 나타냅니다. 모바일 프로모션의 경우 Mobile, 그 외에는 Standard를 반환합니다.
모바일 프로모션을 반환하려면 적절한 customerUserAgent 문자열을 통해 모바일 사이트 또는 앱을 식별해야 합니다.
RateInfo.ChargeableRateInfo 개체 이 개체의 특성은 요금 평균 및 총금액뿐 아니라 예약에 대해 청구된 총금액을 포함합니다. 개별 숙박비와 추가 요금에 세부정보를 제공하는 개체 내 노드입니다.

특성:
total 문자열 예약에 청구되는 모든 숙박비, 세금 및 추가 요금의 총합입니다. 고객에게 표시되어야 하는 전체 값이며 예약 요청에 포함됩니다.
surchargeTotal 문자열 Surcharges 배열의 TaxAndServiceFeeExtraPersonFee의 합계입니다.
nightlyRateTotal 문자열 이 개체 내에 포함된 nightlyRatesPerRoom 배열의 모든 값에 대한 합계입니다.
maxNightlyRate 문자열 반환된 모든 요금에서 가장 높은 1박 요금입니다.
currencyCode 문자열 반환된 요금에 대한 통화 코드입니다.
commissionableUsdTotal 문자열 파트너 수수료를 계산하는 데 사용되는 금액이며 미국 달러 기준입니다. 추가 요금 없는 숙박비 총합입니다.
averageRate 문자열 추가 요금 없이 프로모션 값이 적용된 평균 숙박비입니다.
averageBaseRate 문자열 프로모션 값이 적용되지 않고 추가 요금이 없는 평균 숙박비입니다. 프로모션이 없는 경우 이전 값과 동일한 값이 반환됩니다.
ChargeableRateInfo.
nightlyRatesPerRoom
배열 NightlyRate 배열의 컨테이너입니다. 배열에서 노드의 개수를 나타내기 위해 size 특성을 보유하며, 해당 특성은 요청에서 숙박일수에 해당합니다. 투숙 기간 동안 연속된 순서로 반환되는 요금입니다.
nightlyRatesPerRoom.
NightlyRate
n/a

요청한 투숙 기간 내의 단일 야간 요금을 제공합니다.

프로모션 요금, 기본 요금 및 프로모션이 적용된 이후의 요금이 있는지 나타냅니다(해당하는 경우). 특성만 포함합니다.

여러 객실 요청의 경우, 이 값은 모든 객실의 1박 비용의 평균입니다. EAN은 여러 객실 가격 표시를 위해 새로운 객실별 ChargeableNightlyRates 배열을 사용할 것을 권장합니다.

minorRev=28 이하의 여러 객실 요청의 경우, 이 요소는 평균 요금이 아니라 첫 번째 객실에 대해서만 요금을 제공합니다.

특성:

promo 부울 숙박 요금에 프로모션 요금이 적용되었는지 나타냅니다.
rate 문자열 프로모션이 적용된 이후의 숙박비입니다(해당하는 경우).
baseRate 문자열 프로모션이 적용되기 전의 숙박비입니다(해당하는 경우).
ChargeableRateInfo.Surcharges 배열 Surcharge 배열의 컨테이너입니다. 이 배열은 surchargeTotal에 대해 반환된 값을 구성하는 개별 추가 요금을 나열합니다. 배열에서 노드의 개수를 나타내기 위해 size 특성을 포함합니다.
Surcharges.Surcharge n/a 단일 추가 요금 및 유형에 대한 세부정보입니다. 특성만 포함합니다.

특성:
amount 부동 특정 추가 요금의 총합입니다.
type 문자열 추가 요금 이름입니다.
가능한 값:
  • TaxAndServiceFee
  • ExtraPersonFee
  • Tax
  • ServiceFee
  • SalesTax
  • HotelOccupancyTax

TaxAndServiceFeeExtraPersonFeesurchargeTotal에 반영됩니다. 다른 모든 값은 TaxAndServiceFee 값의 개별 요소입니다.


참고: SalesTaxHotelOccupancyTax 추가요금 유형은 뉴욕 주 법률에 따라 표시되어야 합니다. 최종 요금 내역에서 이러한 값을 "호텔 투숙 및 판매세"로 표시할 수 있는지 확인해야 합니다.
RateInfo.rateType 문자열 반환 요금이 EAN을 통해 선납되는지 호텔에서 후납되는지 여부를 표시합니다. 선불 예약 가능 객실에 대해 MerchantStandard의 값으로 반환되거나 모든 후불에 대해 반환되지 않습니다.
minorRev=18 이상에서 사용 가능합니다.
RateInfo.HotelFees 배열

이 요소는 호텔에서 부과한 특정 세금 및 요금을 분석하며 그렇지 않은 경우 추가 요금 배열에서 상세하게 제공됩니다.

이 요소의 모든 값은 체크인 또는 체크아웃 시 호텔 측에서 청구합니다. 예약 시점에 징수되는 요금의 일부가 아닙니다.

기입되면 주요 검색 엔진 및 애그리게이터에서 필요한 요금/세금/수수료 표시 형식과 일치하도록 이 요소를 사용합니다.

포함된 청구 개수를 나타내도록 size 특성을 포함합니다.
minorRev=19 이상에서 사용 가능합니다.

아동 요소 HotelFeeBreakdown구체적으로 요청해야 하며 minorRev=24 이상이 필요합니다.

HotelFees.HotelFee 없음 설명, 총금액, 단일 요금의 통화에 대한 특성을 포함합니다. VAT, 시/도 세금, 리조트 요금 또는 합법적으로 피할 수 없는 그 외 요금에 대한 세부정보입니다.
ChargeableRateInfocurrencyCode 특성에서 나타내는 예약 가능한 통화에 반환되는 청구입니다.

특성:
description 문자열 청구 유형입니다. 가능한 값:
  • MandatoryFee
  • MandatoryTax
  • ResortFee
amount 문자열 청구에 대한 총합입니다.
HotelFee.HotelFeeBreakdown 없음 요청에서 includeHotelFeeBreakdown이 전송된 경우 반환됩니다. HotelFee에서 제공된 요금이 적용되는 방식과 빈도를 설명합니다.

참고: 모든 HotelFee amount 값은 합계입니다. 이 값을 여기 제공된 frequency로 곱하지 마십시오.

원하는 경우 frequency로 표시된 것처럼 amount로 나누어 1박/1일/1주 요금을 얻을 수 있습니다.

minorRev=24 이상에서 사용 가능합니다.

특성:
unit 문자열 요금이 배포되는 방식입니다. 가능한 값:
  • Per Person
  • Per Room
  • Per accommodation
  • Per house
  • Per apartment
  • Per adult
frequency 문자열 요금의 빈도입니다. 가능한 값:
  • Per Night
  • Per Day
  • Per Stay
  • Per week
ConvertedRateInfo 개체 고객이 요청한 통화로 변환된 요금 정보입니다. 요청된 통화가 호텔에서 비용 청구할 수 없는 통화이거나 고객의 시장 지역 내의 통화인 경우에만 반환됩니다. ChargeableRateInfo와 동일한 특성을 포함합니다.
RoomGroup 개체 제공된 요금에 적용할 때 동일한 RoomGroup 개체의 컨텐츠가 요청에 전송되었는지 확인합니다.

minorRev=29 이상인 경우 객실당 숙박비 세부 정보를 포함합니다.
RoomGroup.Room 배열 원래 요청에서 제공된 numberOfAdults, numberOfChildrenchildAges에 대한 객실 값을 확인합니다.
Room.rateKey 문자열 요금을 결정하는 요율 및 요인에 대한 키입니다.

검색 매개변수가 변경될 때마다(예: 투숙객 수 변경, 숙박 날짜 변경, 아동 추가 등) 새 요청을 전송하여 이 매개변수에 대한 새 값을 얻어야 합니다.
Room.ChargeableNightlyRates 배열 객실의 NightlyRate 배열에 대한 컨테이너입니다. 반환되는 요금은 개별 객실에 특정하며 숙박 기간에 걸쳐 순차적으로 반환됩니다.

여러 객실의 평균 1박 비용을 보려면 nightlyRatesPerRoom에서 제공된 값을 사용합니다.

minorRev=29 이상에 대해서 반환됩니다.
ChargeableNightlyRates.
NightlyRate
개체 요청한 투숙 기간 내의 단일 야간 요금을 제공합니다. 이 위치 이내로 반환되면 요금은 항상 포함 Room에 특정합니다.

프로모션 요금, 기본 요금 및 프로모션이 적용된 이후의 요금이 있는지 나타냅니다(해당하는 경우). 특성만 포함합니다.

minorRev=29 이상에 대해서 반환됩니다.

특성:
promo 부울 숙박 요금에 프로모션 요금이 적용되었는지 나타냅니다.
rate 문자열 프로모션이 적용된 이후의 숙박비입니다(해당하는 경우).
baseRate 문자열 프로모션이 적용되기 전의 숙박비입니다(해당하는 경우).
ChargeableNightlyRates.
ConvertedNightlyRates
개체 고객이 요청한 통화로 변환된 요금 정보입니다. 요청된 통화가 호텔에서 비용 청구할 수 없는 통화이거나 고객의 시장 지역 내의 통화인 경우에만 반환됩니다. ChargeableNightyRates와 동일한 특성을 포함합니다. minorRev=29 이상에 대해서 반환됩니다.
CachedSupplierResponse


캐시된 호텔 목록 응답이 제공되면 CachedSupplierResponse 요소가 반환됩니다.

CachedSupplierResponse 요소에 대한 특성:
이름 설명
cachedSupplierResponse 개체 캐시된 데이터에 대한 정보가 포함되며 내부 용도입니다. 캐시된 응답으로만 반환됩니다.
cacheEntryHitNum 정수 내부용입니다.
cacheEntryMissNum 정수 내부용입니다.
cacheEntryExpiredNum 정수 내부용입니다.
cacheRetrievalTime 정수(Long) 캐시 검색 시간입니다.
supplierRequestNum 정수 공급업체에서 요청된 결과 수입니다.
supplierResponseNum 정수 공급업체에서 반환된 결과 수입니다.
supplierResponseTime 정수(Long) 공급업체가 결과를 반환한 속도입니다.
candidatePrepTime 정수(Long) 숙박업소의 요청 목록을 판단 또는 준비하는 시간입니다.
tpidUsed 정수 통화 및 로케일에 기반을 둔 내부 식별자입니다.
matchedCurrency 부울 캐시에서 일치 또는 변환(외삽)된 데이터를 반환합니다.
matchedLocale 부울 캐시에서 일치 또는 번역된 데이터를 반환합니다.
extrapolatedCurrency 부울 캐시에서 일치 또는 변환(외삽)된 데이터를 반환합니다. (결과는 공급업체로부터 영어와 USD로 캐시되지만 요청 시 요청된 통화 및 언어로 변환됩니다.)
extrapolatedLocale 부울 캐시에서 일치 또는 번역된 데이터를 반환합니다.