Developer Hub
자동 생성된 번역입니다.

glsr_dfdhbhbz에 대한 API 제공

glsr_dfdhbhbz를 사용하면 고객의 예약 정보를 표시하고 투어나 체험과 같은 booking-related 상품이나 서비스를 찾을 수 있도록 도와줄 수 있습니다. 또한 데이터를 사용하여 예약 트렌드를 분석하고 이해관계자를 위한 보고서를 작성할 수도 있습니다.

배송 옵션

glsr_dfdhbhbz 데이터의 API 전송은 푸시 또는 풀 메커니즘을 사용할 수 있습니다.

푸시 메커니즘

푸시 서비스는 업데이트가 발생하면 일정 업데이트를 전송합니다. 핵심 예약 필드는 거래 후 몇 분 이내에 사용할 수 있으며, 보조 및 보강 필드는 2~4시간 이내에 사용할 수 있습니다. 이 옵션을 사용하면 다음과 같이 할 수 있습니다:

  • 웹사이트 또는 앱에 고객의 예약 정보를 표시합니다.
  • 여행자에게 여행에 필요한 추가 상품 및 서비스 제공

푸시 이벤트는 웹훅을 통해 HTTP POST메시지 형식으로 사용자가 제공한 URL로 전달됩니다. 이러한 메시지는 순서 없이 도착할 수 있으므로 creation_date및 update_date_time요소를 참조하여 순서를 결정하세요.

이 배달 옵션을 채택하는 방법에 대한 자세한 내용은 API 설정을 참조하세요.

푸시 이벤트 작업

일정 데이터는 사용 가능해지면 전달되기 때문에 동일한 #일정에 대해 핵심 필드가 포함된 초기 이벤트와 보조 데이터가 보강되거나 #일정가 업데이트되면 후속 이벤트가 이어지는 여러 이벤트를 수신할 수 있습니다. 실시간으로 도착하는 필드와 2~4시간 이내에 도착하는 필드에 대한 전체 분석은 사용 가능한 필드 를 참조하세요.

Do:

  • 일정: itinerary_id을 사용하여 이벤트를 상호 연관시키고 항상 최신 update_date_time으로 이벤트를 권위 있는 것으로 취급합니다.
  • 업데이트 처리 방법 선택: 기존 일정 대한 새 이벤트를 수신하면 이전 기록을 최신 데이터로 덮어쓰거나 각 이벤트를 추가하여 변경 내역을 유지할 수 있습니다.
  • 누락된 필드를 정상적으로 처리: 초기 이벤트에서 보조 필드가 누락될 수 있으므로 처리하기 전에 필드 존재 여부를 확인합니다.

하지 말아야 할 것

  • 첫 번째 이벤트에 전체 페이로드가 포함되어 있다고 가정합니다: 보조 필드는 이후 이벤트에서 다음과 같이 이어집니다.
  • 동일한 일정에 대한 여러 이벤트를 오류로 처리: 이는 예상되는 동작입니다.
  • real-time 재무 가치를 최종 가치로 취급: 24시간 이내에 수정될 수 있습니다.

풀 메커니즘

Checkmark

참고

풀 배송은 화이트 라벨 여행 플랫폼 파트너만 이용할 수 있습니다.

풀 서비스는 자세한 일정 데이터를 지원합니다:

  • 데이터 분석
  • Expedia Group 데이터에 대한 예약 기록 조정
  • 푸시 전송이 실패한 기간에 대한 데이터 검색
  • 헬프 데스크 조사

푸시 전달과 마찬가지로 풀 전달의 경우 일정 데이터는 두 가지 계층으로 제공됩니다. 핵심 필드(itinerary_ID, status, gross_booking_value, checkin_date, checkout_date)는 예약 또는 업데이트 후 몇 분 이내에 액세스할 수 있으며, 보조 및 보강 필드는 2~4시간 이내에 이어서 액세스할 수 있습니다. 필드별 전체 분석은 사용 가능한 필드 를 참조하세요.

이 서비스는 두 개의 HTTP GET엔드포인트로 구성되어 있습니다:

  • creation_date_start, creation_date_end, update_date_time_start, update_date_time_end변수를 사용하여 지정된 시간 범위에서 생성 또는 업데이트된 일정 목록을 만듭니다.
  • 특정 #glsr_dfdhbhbz를 검색합니다. itinerary_id

인증 프로세스에 대한 자세한 내용은 API 설정 을 참조하세요.

시간 창으로 일정 데이터 검색하기

지정된 기간 동안의 일정 데이터를 검색하려면 GET /itineraries및 update_date_time_start을 쿼리 창으로 사용하여 update_date_time_end엔드포인트를 폴링합니다.

권장 접근 방식:

  1. update_date_time 필드를 쿼리 창으로 사용합니다:update_date_time_start 및 update_date_time_end을 쿼리 창으로 사용하여 특정 기간에 생성 또는 업데이트된 #glsr_dfdhbhbz를 검색합니다. creation_date만 사용하면 일정 업데이트를 놓치게 됩니다.
  2. 마지막으로 성공한 투표 타임스탬프를 유지합니다: 이를 다음 update_date_time_start으로 사용하여 창을 점진적으로 진행합니다.
  3. 중복: 쿼리에 itinerary_id + update_date_time을 사용합니다. 보조 필드가 강화됨에 따라 여러 설문조사 창에 동일한 일정 표시될 수 있습니다. 항상 최신 update_date_time으로 된 기록을 권위 있는 것으로 취급하세요.

사용 사례에 가장 완전하고 시기적절한 일정 데이터가 필요한 경우 푸시 전송을 권장합니다.

사용 가능한 필드

아래 표에는 중첩된 개체를 포함하여 푸시 및 풀 제공 방식을 통해 사용 가능한 필드가 나열되어 있습니다. 사용 가능성 열은 예약 이벤트 또는 업데이트 후 각 필드에 일반적으로 액세스할 수 있는 시기를 나타냅니다:

  • 실시간: 예약 또는 업데이트 후 몇 분 이내에 이용 가능
  • Near-real-time: 예약 또는 업데이트 후 2~4시간 이내에 사용 가능

이름과 그 뒤의 마침표로 시작하는 필드 이름(예: <variable>.<nested variable>)은 중첩 관계를 나타냅니다.

화이트 레이블 여행 플랫폼

필드 이름정의예예약 가능 객실
itinerary_id일정 번호 또는 POS 주문 참조 번호입니다.72622069245694실시간
status일정 및 개별 항목의 상태입니다.가능한 값입니다:
confirmed
취소됨		실시간
creation_date*예약이 처음 이루어진 날짜로, ISO 8601 날짜 형식으로 표시됩니다(YYYY-MM-DD).2023-02-05실시간
update_date_time*ISO 8601 날짜 형식으로 표시되는 일정 마지막 업데이트 날짜 및 시간(YYYY-MM-dd'T"HH:mm:ss.SSSZ).2023-10-21T00:00:00.000Z실시간
onlineglsr_dfdhbhaz가 온라인(참) 또는 에이전트를 통해 예약되었는지 여부(거짓)를 나타냅니다. 부울 값으로 표시됩니다.trueNear-real-time
packageglsr_dfdhbhaz가 패키지의 일부인지 아니면 독립형 예약인지 표시합니다. 부울 값으로 표시됩니다.falseNear-real-time
payment_type결제 페이지에서 사용한 결제 수단입니다.가능한 값:
신용카드
포인트
분할 결제		실시간
point_of_sale_country_code고객이 예약을 한 POS의 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.GBNear-real-time
purchaser예약한 사람의 신원 정보입니다. 중첩된 항목의 목록은 purchaser 표를 참조해 주세요.  
property_booking_items일정의 일부로 예약된 숙박 시설 구성 요소입니다. 중첩된 항목의 목록은 property_booking_items 표를 참조해 주세요.  
flight_booking_items일정의 일부로 예약된 항공 구성 요소입니다. 중첩된 항목의 목록은 flight_booking_items 표를 참조해 주세요.  
car_booking_items일정의 일부로 예약된 렌터카 구성 요소입니다. 중첩된 항목의 목록은 car_booking_items 표를 참조해 주세요.  
activity_booking_items일정의 일부로 예약된 즐길거리 구성 요소입니다. 중첩된 항목의 목록은 activity_booking_items 표를 참조해 주세요.  
insurance_booking_items일정의 일부로 예약된 보험 구성 요소입니다. 중첩된 항목의 목록은 insurance_booking_items 표를 참조해 주세요.  
rate예약 항목 또는 전체 일정의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요.  
coupon해당되는 경우 일정에 적용된 쿠폰입니다. 중첩된 항목의 목록은 coupon 표를 참조해 주세요.  
|

purchaser

이 필드는 예약한 사람을 식별합니다.

필드 이름정의예예약 가능 객실
purchaser.email**예약한 사람의 이메일 주소입니다.smith@example.com실시간
purchaser.loyalty_id**회원혜택 프로그램 멤버십 식별자입니다.12345678Near-real-time
purchaser.first_name**예약한 사람의 이름입니다.Jane실시간
purchaser.last_name**예약한 사람의 성입니다.Smith실시간

property_booking_items

이러한 필드는 일정의 일부로 예약된 숙박 시설 구성 요소를 나열합니다.

필드 이름정의예예약 가능 객실
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882912실시간
status특정 숙박 시설 요소의 상태입니다.가능한 값입니다:
confirmed
취소됨		실시간
checkin_date*해당 숙박 시설 요소의 체크인 날짜입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-01실시간
checkout_date*해당 숙박 시설 요소의 체크아웃 날짜입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-05실시간
property.idExpedia Group's 호텔 또는 휴가용 숙소의 고유 식별자 숙박 시설.1400882912Near-real-time
property.chain_name해당되는 경우 숙박 시설이 속한 체인의 이름입니다.독립 브랜드Near-real-time
property.brand_name해당되는 경우 숙박 시설이 속한 브랜드의 이름입니다. 한 체인에 여러 브랜드가 있을 수 있습니다.사보이 시그니처Near-real-time
property.name호텔 또는 휴가용 주택의 이름입니다.호텔 1실시간
property.city숙박 시설이 위치한 도시의 이름입니다.토론토실시간
property.state_province_name숙박 시설이 위치한 주 또는 도의 이름입니다.온타리오Near-real-time
property.country_code숙박 시설이 위치한 국가의 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA실시간
property.star_rating숙박 시설의 등급입니다.3.0Near-real-time
room_name호텔 또는 휴가용 렌탈업체에서 정의한 예약 객실 유형입니다.Comfort 전용 욕실이 있는 더블룸Near-real-time
adult_count해당 예약에 포함된 성인의 인원수입니다.2실시간
child_count해당 예약에 포함된 어린이의 인원수입니다.0실시간
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.trueNear-real-time
property_confirmation_id호텔 또는 휴가용 렌탈 업체에서 제공한 확인 번호입니다.1516171819Near-real-time
rate숙박 시설 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요.  

flight_booking_items

이러한 필드는 일정의 일부로 예약된 항공 구성 요소를 나열합니다.

필드 이름정의예예약 가능 객실
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882911실시간
status특정 항공 요소의 상태입니다.가능한 값입니다:
confirmed
취소됨		실시간
departure_date*해당 항공 여행 요소의 시작일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-01실시간
arrival_date*해당 항공 여행 요소의 종료일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-02실시간
airline.plating_carrier_name항공권을 발행한 항공사의 이름입니다.에어캐나다Near-real-time
airline.plating_carrier_code국제항공운송협회(IATA) 항공권을 발권한 항공사의 코드.AC실시간
carrier_pnr항공권을 발권한 항공사의 기록에 있는 승객 이름입니다.SMITHNear-real-time
trip_type예약한 여행의 유형입니다.가능한 값:
편도
왕복
다구간 목적지		Near-real-time
fare_class티켓의 좌석 등급입니다.이코노미Near-real-time
airport_origin_code출발지 공항의 IATA 코드입니다.LHR실시간
airport_origin_location출발 공항의 위치입니다.런던, 영국(LHR-히드로)Near-real-time
airport_destination_code도착 공항의 코드입니다. IATA 형식으로 표시됩니다.YYZ실시간
airport_destination_location도착 공항의 위치입니다.토론토, 온타리오(YYZ-레스터 B. 피어슨 국제공항)Near-real-time
ticket_number항공편의 티켓 번호입니다.123456789Near-real-time
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.trueNear-real-time
segment_count항공권의 항공편 구간 수입니다.1Near-real-time
rate항공편 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요.  

car_booking_items

이러한 필드는 일정의 일부로 예약된 렌터카 구성 요소를 나열합니다.

필드 이름정의예예약 가능 객실
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882910실시간
status특정 렌터카 여행 요소의 상태입니다.가능한 값입니다:
confirmed
취소됨		실시간
pickup_date*렌터카 여행 요소의 시작일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-02실시간
return_date*렌터카 여행 요소의 종료일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-05실시간
rental_company.name렌터카 회사 이름입니다.Hertz실시간
car_type렌터카 유형입니다.2/4도어 소형차Near-real-time
pickup_location렌터카의 픽업 위치입니다.디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역)실시간
pickup_country_code렌터카 픽업 위치의 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA실시간
return_location렌터카의 반납 위치입니다.디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역)실시간
return_country_code렌터카 반납 위치의 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA실시간
trip_type예약한 여행의 유형입니다.가능한 값:
편도
왕복
다구간 목적지		Near-real-time
rental_company_confirmation_id렌터카 회사에서 제공한 확인 번호입니다.ABC1234Near-real-time
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.falseNear-real-time
rate렌터카 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요.  

activity_booking_items

이러한 필드는 일정의 일부로 예약된 즐길거리 구성 요소를 나열합니다.

필드 이름정의예예약 가능 객실
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882910실시간
status특정 즐길거리의 상태입니다.가능한 값입니다:
confirmed
취소됨		실시간
activity_start_date*즐길거리의 시작일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-03실시간
activity_end_date*즐길거리의 종료일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-03실시간
vendor.name즐길거리를 제공하는 공급업체의 이름입니다.올리비아의 투어실시간
vendor.city즐길거리 공급업체가 위치한 도시입니다.디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역)실시간
vendor.country_code즐길거리 공급업체가 위치한 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA실시간
offering_name즐길거리의 이름입니다.패션 오브 파라다이스 - 그레이트 배리어 리프Near-real-time
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.trueNear-real-time
rate즐길거리 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요.  

insurance_booking_items

이러한 필드는 일정의 일부로 예약된 보험 구성 요소를 나열합니다.

필드 이름정의예예약 가능 객실
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882610실시간
status선택한 특정 보험의 상태입니다.가능한 값입니다:
confirmed
취소됨		실시간
rate선택한 보험의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요.  

rate

이러한 필드는 예약 항목 또는 전체 일정의 요금 및 가격 세부 정보를 나열합니다. 여기에는 예약의 금전적 가치를 설명하는 중첩된 값이 포함되며, 총 예약 가치와 세금 및 수수료로 세분화됩니다.

필드 이름정의예예약 가능 객실
rate_plan_name항목의 가격에 사용된 요금제의 이름입니다. 숙박 시설 예약 상품에만 사용할 수 있습니다.룸온리Near-real-time
rate_plan_type예약에 사용된 요금 유형입니다. 숙박 시설 예약 상품에만 사용할 수 있습니다.판매 요금Near-real-time
refundable해당 예약 구성요소가 환불 가능한지 여부(참) 또는 환불 불가능(거짓)입니다.trueNear-real-time
pricing예약의 금전적 가치를 캡처하는 개체로, 총 예약 가치와 세금 및 수수료로 세분화됩니다.  
pricing.gross_booking_value예약의 금전적 가치를 캡처하는 객체입니다.  
pricing.gross_booking_value.billable_currency결제에 사용된 통화로 예약의 금전적 가치를 나타내는 객체입니다.  
pricing.gross_booking_value.billable_currency.currency고객이 예약을 결제하는 통화입니다. ISO 4217 형식으로 표시됩니다.GBP실시간
pricing.gross_booking_value.billable_currency.value총 예약 금액입니다.2520.80실시간
pricing.taxes_and_fees예약에 대한 세금 및 수수료의 금액과 통화입니다.  
pricing.taxes_and_fees.billable_currency예약에 대한 세금 및 수수료의 금액(결제에 사용된 통화 기준)입니다.  
pricing.taxes_and_fees.billable_currency.currency고객이 예약을 결제하는 통화입니다. ISO 4217 형식으로 표시됩니다.GBP실시간
pricing.taxes_and_fees.billable.currency.value총 예약 금액입니다.491.10실시간

coupon

필드 이름정의예예약 가능 객실
code예약에 사용된 쿠폰 코드입니다.ABCDNear-real-time
name쿠폰 이름입니다.PRIMENear-real-time
description쿠폰에 대한 설명입니다.BoGo 5%Near-real-time
currency쿠폰 금액이 적용된 통화입니다. ISO 4217 형식으로 표시됩니다.GBPNear-real-time
value쿠폰의 금액입니다.126.04Near-real-time

모든 화이트 라벨 여행 플랫폼 필드에 대한 참고 사항

  • 날짜 필드는 협정 세계시(UTC) 기준입니다.
    ** 개인 식별 정보(PII) 데이터를 나타냅니다. 회사의 가이드라인에 따라 올바르게 처리해야 합니다. 꼭 필요한 경우에만 포함하세요.

여행사 제휴 프로그램(TAAP)

필드 이름정의예예약 가능 객실
itinerary_id일정 번호 또는 POS 주문 참조 번호입니다.72622069245694실시간
agency_reference_code결제 시 대행사 측에서 제공한 사용자 지정 일정 참조입니다.86549B_GB실시간
status일정 및 개별 항목의 상태입니다.가능한 값입니다:
confirmed
취소됨		Near-real-time
creation_date*예약이 처음 이루어진 날짜로, ISO 8601 날짜 형식으로 표시됩니다(YYYY-MM-DD).2023-02-05실시간
update_date_time*ISO 8601 날짜 형식으로 표시된 일정 마지막 업데이트 날짜 및 시간(YYYY-MM-dd'T"HH:mm:ss.SSSZ).2023-10-21T00:00:00.000Z실시간
online일정 온라인으로 예약되었는지(true), 아니면 에이전트를 통해 예약되었는지(false)를 나타냅니다. 부울 값으로 표시됩니다.trueNear-real-time
point_of_sale_country_code고객이 예약한 국가의 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.GBNear-real-time
purchaser예약한 사람의 신원 정보입니다. 중첩된 항목의 목록은 purchaser 표를 참조해 주세요.  
agency예약을 진행한 TAAP 여행사 및 에이전트의 신원 확인. 중첩된 항목의 목록은 agency 표를 참조해 주세요.  
payment일정 대한 결제 정보입니다. 중첩된 항목의 목록은 payment 표를 참조해 주세요.  
property_booking_items일정의 일부로 예약된 숙박 시설 구성 요소입니다. 중첩된 항목의 목록은 property_booking_items 표를 참조해 주세요.  
flight_booking_items일정의 일부로 예약된 항공 구성 요소입니다. 중첩된 항목의 목록은 flight_booking_items 표를 참조해 주세요.  
car_booking_items일정의 일부로 예약된 렌터카 구성 요소입니다. 중첩된 항목의 목록은 car_booking_items 표를 참조해 주세요.  
activity_booking_items일정의 일부로 예약된 즐길거리 구성 요소입니다. 중첩된 항목의 목록은 activity_booking_items 표를 참조해 주세요.  
rate예약 항목 또는 전체 일정의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요.  
earnings예약 항목 또는 전체 일정 수수료 세부 정보입니다. 중첩된 항목의 목록은 earnings 표를 참조해 주세요.  
|

purchaser

이 필드는 여행할 사람을 식별합니다.

필드 이름정의예예약 가능 객실
purchaser.email**여행자의 이메일 주소.smith@example.com실시간
purchaser.first_name**여행자의 이름입니다.Jane실시간
purchaser.last_name**여행자의 성입니다.Smith실시간

에이전시

이 필드는 예약을 진행한 TAAP 여행사 및 에이전트를 식별합니다.

필드 이름정의예예약 가능 객실
agency.name예약을 진행한 여행사( TAAP )의 이름입니다.세계 여행Near-real-time
agency.id예약을 진행한 TAAP 여행사의 추적 코드입니다.WS02555실시간
agency.agent.first_name**예약을 진행한 TAAP 상담원의 이름입니다.Bob실시간
agency.agent.last_name**예약을 진행한 TAAP 상담원의 성입니다.Jones실시간
agency.agent.email**예약을 진행한 TAAP 상담원의 이메일 주소입니다.bjones@worldtravel.com실시간

결제 내역

이 필드에는 일정에 대한 결제 세부 정보가 포함되어 있습니다.

필드 이름정의예예약 가능 객실
payment_type결제 페이지에서 사용한 결제 수단입니다.가능한 값:
신용카드
포인트
분할 급여		실시간
status일정 결제되었는지 여부를 나타냅니다.가능한 값:
유료
미지급		Near-real-time
deferred일정 대한 결제가 연기되었는지(참) 또는 결제되었는지(거짓) 여부입니다. 부울 값으로 표시됩니다.trueNear-real-time
payment_due_date결제 기한 ISO 8601 날짜 형식(YYYY-MM-DD). 후불 결제에만 적용됩니다.2023-02-05Near-real-time
payee일정 결제의 책임자가 누구인지 표시합니다.가능한 값:
에이전시
고객		Near-real-time

property_booking_items

이러한 필드는 일정의 일부로 예약된 숙박 시설 구성 요소를 나열합니다.

필드 이름정의예예약 가능 객실
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882912실시간
status특정 숙박 시설 요소의 상태입니다.가능한 값:
확정됨
취소됨		실시간
checkin_date*해당 숙박 시설 요소의 체크인 날짜입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-01실시간
checkout_date*해당 숙박 시설 요소의 체크아웃 날짜입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-05실시간
property.idExpedia Group's 호텔 또는 휴가용 임대 숙소의 고유 식별자 숙박 시설1400882912Near-real-time
property.chain_name해당되는 경우 숙박 시설이 속한 체인의 이름입니다.독립 브랜드Near-real-time
property.brand_name해당되는 경우 숙박 시설이 속한 브랜드의 이름입니다. 한 체인에 여러 브랜드가 있을 수 있습니다.사보이 시그니처Near-real-time
property.name호텔 또는 휴가용 주택의 이름입니다.호텔 1실시간
property.city숙박 시설이 위치한 도시의 이름입니다.토론토실시간
property.state_province_name숙박 시설이 위치한 주 또는 도의 이름입니다.온타리오Near-real-time
property.country_code숙박 시설이 위치한 국가의 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA실시간
property.star_rating숙박 시설의 등급입니다.3.0Near-real-time
room_name호텔 또는 휴가용 렌탈업체에서 정의한 예약 객실 유형입니다.Comfort 전용 욕실이 있는 더블룸Near-real-time
adult_count예약에 포함된 성인 수입니다.2실시간
child_count예약에 포함된 어린이 수입니다.0실시간
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.trueNear-real-time
property_confirmation_id호텔 또는 휴가용 렌탈 업체에서 제공한 확인 번호입니다.1516171819Near-real-time
rate숙박 시설 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요.  
earnings숙박 예약의 수수료 세부 정보입니다. 중첩된 항목의 목록은 earnings 표를 참조해 주세요.  

flight_booking_items

이러한 필드는 일정의 일부로 예약된 항공 구성 요소를 나열합니다.

필드 이름정의예예약 가능 객실
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882911실시간
status특정 항공 요소의 상태입니다.가능한 값입니다:
confirmed
취소됨		실시간
departure_date*해당 항공 여행 요소의 시작일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-01실시간
arrival_date*해당 항공 여행 요소의 종료일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-02실시간
airline.plating_carrier_name항공권을 발행한 항공사의 이름입니다.에어캐나다Near-real-time
airline.plating_carrier_codeIATA 항공권을 발권한 항공사의 코드를 입력합니다.AC실시간
carrier_pnr항공권을 발권한 항공사의 기록에 있는 승객 이름입니다.SMITHNear-real-time
trip_type예약한 여행의 유형입니다.가능한 값:
편도
왕복
다구간 목적지		Near-real-time
fare_class티켓의 좌석 등급입니다.이코노미Near-real-time
airport_origin_code출발지 공항의 IATA 코드입니다.LHR실시간
airport_origin_location출발 공항의 위치입니다.런던, 영국(LHR-히드로)Near-real-time
airport_destination_code도착 공항의 코드입니다. IATA 형식으로 표시됩니다.YYZ실시간
airport_destination_location도착 공항의 위치입니다.토론토, 온타리오(YYZ-레스터 B. 피어슨 국제공항)Near-real-time
ticket_number항공편의 티켓 번호입니다.123456789101Near-real-time
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.trueNear-real-time
segment_count항공권의 항공편 구간 수입니다.1Near-real-time
rate항공편 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요.  
earnings항공편 예약의 수수료 세부 정보입니다. 중첩된 항목의 목록은 earnings 표를 참조해 주세요.  

car_booking_items

이러한 필드는 일정의 일부로 예약된 렌터카 구성 요소를 나열합니다.

필드 이름정의예예약 가능 객실
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882910실시간
status특정 렌터카 여행 요소의 상태입니다.가능한 값입니다:
confirmed
취소됨		실시간
pickup_date*렌터카 여행 요소의 시작일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-02실시간
return_date*렌터카 여행 요소의 종료일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-05실시간
rental_company.name렌터카 회사 이름입니다.Hertz실시간
car_type렌터카 유형입니다.2/4도어 소형차Near-real-time
pickup_location렌터카의 픽업 위치입니다.디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역)실시간
pickup_country_code렌터카 픽업 위치의 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA실시간
return_location렌터카의 반납 위치입니다.디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역)실시간
return_country_code렌터카 반납 위치의 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA실시간
trip_type예약한 여행의 유형입니다.가능한 값:
편도
왕복
다구간 목적지		Near-real-time
rental_company_confirmation_id렌터카 회사에서 제공한 확인 번호입니다.ABC1234Near-real-time
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.falseNear-real-time
rate렌터카 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요.  
earnings차량 예약의 수수료 세부 정보입니다. 중첩된 항목의 목록은 earnings 표를 참조해 주세요.  

activity_booking_items

이러한 필드는 일정의 일부로 예약된 즐길거리 구성 요소를 나열합니다.

필드 이름정의예예약 가능 객실
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882910실시간
status특정 즐길거리의 상태입니다.가능한 값입니다:
confirmed
취소됨		실시간
activity_start_date*즐길거리의 시작일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-03실시간
activity_end_date*즐길거리의 종료일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-03실시간
vendor.name즐길거리를 제공하는 공급업체의 이름입니다.올리비아의 투어실시간
vendor.city즐길거리 공급업체가 위치한 도시입니다.디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역)실시간
vendor.country_code즐길거리 공급업체가 위치한 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA실시간
offering_name즐길거리의 이름입니다.험버 강 트레일 하이킹Near-real-time
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.trueNear-real-time
rate즐길거리 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요.  
earnings액티비티 예약 항목의 수수료 세부 정보입니다. 중첩된 항목의 목록은 earnings 표를 참조해 주세요.  

rate

이러한 필드는 예약 항목 또는 전체 일정의 요금 및 가격 세부 정보를 나열합니다. 여기에는 예약의 금전적 가치를 설명하는 중첩된 값이 포함되며, 총 예약 가치와 세금 및 수수료로 세분화됩니다.

필드 이름정의예예약 가능 객실
refundable해당 예약 구성요소가 환불 가능한지 여부(참) 또는 환불 불가능(거짓)입니다.trueNear-real-time
pricing예약의 금전적 가치를 캡처하는 개체로, 총 예약 가치와 세금 및 수수료로 세분화됩니다.  
pricing.gross_booking_value세금 및 수수료를 포함한 예약 금액입니다.  
pricing.gross_booking_value.billable_currency예약 금액(결제에 사용된 통화 기준)입니다.  
pricing.gross_booking_value.billable_currency.currency고객이 예약을 결제하는 통화입니다. ISO 4217 형식으로 표시됩니다.GBP실시간
pricing.gross_booking_value.billable_currency.value총 예약 금액입니다.2520.80실시간
pricing.taxes_and_fees예약에 대한 세금 및 수수료의 금액과 통화입니다.  
pricing.taxes_and_fees.billable_currency예약에 대한 세금 및 수수료의 금액(결제에 사용된 통화 기준)입니다.  
pricing.taxes_and_fees.billable_currency.currency고객이 예약을 결제하는 통화입니다. ISO 4217 형식으로 표시됩니다.GBP실시간
pricing.taxes_and_fees.billable.currency.value총 예약 금액입니다.491.10실시간

수익

필드 이름정의예예약 가능 객실
commission총 예약 금액에 포함된 예약 또는 아이템의 수수료 금액을 나타내는 객체입니다.  
commission.billable_currency결제 통화로 수수료 금액을 나타내는 객체입니다.  
commission.billable_currency.currencyISO 4217 형식으로 표시되는 수수료 값의 통화USD실시간
commission.billable_currency.value수수료의 금전적 가치.100.25실시간
service_chargeTAAP 대행사가 일정 적용한 서비스 수수료를 나타내는 개체입니다.  
service_charge.amountTAAP 대행사가 일정 적용한 서비스 수수료의 금전적 가치를 나타내는 개체입니다.  
service_charge.amount.billable_currency결제 통화로 서비스 수수료 금액을 나타내는 객체입니다.  
service_charge.amount.billable_currency.currencyISO 4217 형식으로 표시되는 서비스 요금 값의 통화입니다.USD실시간
service_charge.amount.billable_currency.valueTAAP 대행사가 일정 적용한 서비스 수수료의 금전적 가치입니다.50.50실시간
service_charge.taxes_and_fees서비스 요금에 대한 세금 및 수수료의 가치와 통화를 나타내는 객체입니다.  
service_charge.taxes_and_fees.billable_currency서비스 요금에 대한 세금 및 수수료의 금전적 가치를 결제 통화로 나타내는 객체입니다.  
service_charge.taxes_and_fees.billable_currency.currency결제 통화, ISO 4217 형식으로 표시됩니다.USD실시간
service_charge.taxes_and_fees.billable_currency.value고객이 세금 및 수수료로 결제한 금액(청구 통화 기준)입니다.5.25실시간

모든 TAAP 필드에 대한 참고 사항

  • 날짜 필드는 협정 세계시(UTC) 기준입니다.
    ** 개인 식별 정보(PII) 데이터를 나타냅니다. 회사의 가이드라인에 따라 올바르게 처리해야 합니다. 꼭 필요한 경우에만 포함하세요.

API 세부 정보

비즈니스에서 일정 API 데이터를 사용하는 방식에 따라 API 스키마 및 구성에 대한 스냅샷을 제공했습니다. OpenAPI 사양을 다운로드하고 API 테스트 도구를 사용하여 예제 및 스키마 정의가 실제 출력과 어떻게 비교되는지 이해할 수 있습니다.

화이트 레이블 여행 플랫폼

푸시 및 풀 전달 방법을 통해 화이트 라벨 여행 플랫폼 파트너가 사용할 수 있는 중첩된 개체를 포함한 필드는 다음과 같습니다:




탭

푸시 전달 방법을 통해 TAAP 파트너가 사용할 수 있는 필드(중첩된 개체 포함)는 다음과 같습니다:




이 페이지가 도움이 되었나요?
이 콘텐츠를 어떻게 개선하면 좋을까요?
더 나은 Developer Hub를 만드는 데 도움을 주셔서 감사합니다!

개인정보 처리방침 쿠키 정책 이용약관

Expedia, Inc.는 외부 웹사이트 콘텐츠에 대해 책임을 지지 않습니다.
© 2026 Expedia, Inc. Expedia Group 회사. All rights reserved. Expedia 및 비행기 로고는 Expedia, Inc.의 상표 또는 등록 상표입니다. CST# 2029030-50.