일정 API

실시간에 가까운 고객 예약 데이터에 액세스

일정 API를 통해 고객의 예약 정보를 표시하고 고객이 투어나 체험과 같은 예약 관련 상품이나 서비스를 찾도록 지원할 수 있습니다. 또한 이 API의 데이터를 사용하여 예약 동향을 분석하고 이해관계자를 위한 보고서를 생성할 수 있습니다.

사용 가능한 필드

아래 표에는 중첩된 개체를 포함하여 푸시 및 풀 제공 방식을 통해 사용 가능한 필드가 나열되어 있습니다.

필드 이름	정의	예
`itinerary_id`	일정 번호 또는 POS 주문 참조 번호입니다.	72622069245694
`status`	일정 및 개별 항목의 상태입니다.	가능한 값: 예약됨 취소됨
`creation_date`*	최초 예약 날짜는 ISO8601 날짜 형식(YYYY-MM-DD)으로 표시됩니다.	2023-02-05
`update_date_time`*	일정의 마지막 업데이트 날짜 및 시간으로, ISO8601 날짜 형식(YYYY-MM-dd"T"HH:mm:ss.SSSZ)으로 표시됩니다.	2023-10-21T00:00:00.000-08:00
`online`	일정이 온라인으로 예약되었는지 또는 상담원을 통해 예약되었는지를 나타냅니다. 부울 값으로 표시됩니다.	true
`package`	일정이 온라인으로 예약되었는지 또는 상담원을 통해 예약되었는지를 나타냅니다. 부울 값으로 표시됩니다.	false
`payment_type`	결제 페이지에서 사용한 결제 수단입니다.	가능한 값: 신용카드 포인트 분할 결제
`point_of_sale_country_code`	고객이 예약을 한 POS의 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.	GB
`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`**	회원혜택 프로그램 멤버십 식별자입니다.	12345678

property_booking_items

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

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

flight_booking_items

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

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

car_booking_items

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

필드 이름	정의	예
`booking_item_id`	일정의 일부로 예약된 특정 요소의 식별자입니다.	1400882910
`status`	특정 렌터카 여행 요소의 상태입니다.	가능한 값: 예약됨 취소됨
`pickup_date`*	렌터카 여행 요소의 시작일입니다. ISO8601 날짜 형식(YYYY-MM-DD)으로 표시됩니다.	2023-02-02
`return_date`*	렌터카 여행 요소의 종료일입니다. ISO8601 날짜 형식(YYYY-MM-DD)으로 표시됩니다.	2023-02-05
`rental_company.name`***	렌터카 회사 이름입니다.	Hertz
`car_type`***	렌터카 유형입니다.	2/4도어 소형차
`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`	예약한 여행의 유형입니다.	가능한 값: 편도 왕복 다구간 목적지
`rental_company_confirmation_id`***	렌터카 회사에서 제공한 확인 ID입니다.	ABC1234
`expedia_collect`	예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.	false
`rate`	렌터카 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 `rate` 표를 참조해 주세요.

activity_booking_items

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

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

insurance_booking_items

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

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

rate 및 pricing

이러한 필드는 예약 항목 또는 전체 일정의 요금 및 가격 세부 정보를 나열합니다.

rate

필드 이름	정의	예
`rate_plan_name`	항목의 가격에 사용된 요금제의 이름입니다. property_booking_items에만 사용할 수 있습니다.	룸온리
`rate_plan_type`	예약에 사용된 요금 유형입니다. property_booking_items에만 사용할 수 있습니다.	판매 요금
`refundable`	해당 예약 구성 요소가 환불 가능한지 여부입니다.	true

pricing

이 필드에는 예약 금액을 기술하는 중첩된 값이 있으며, 총 예약 금액과 세금 및 수수료로 세분화되어 있습니다. 필드는 유연성을 위해 중첩되어 있습니다.

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

필드 이름	정의	예
`taxes_and_fees`	예약에 대한 세금 및 수수료의 금액과 통화입니다. 아래 중첩된 항목을 참조해 주세요.
`gross_booking_value`	세금 및 수수료를 포함한 예약 금액입니다.	2523.00
`taxes_and_fees.billable_currency`	예약에 대한 세금 및 수수료의 금액(결제에 사용된 통화 기준)입니다. `taxes_and_fees` 변수 아래에 중첩됩니다. 아래 중첩된 항목을 참조해 주세요.
`gross_booking_value.billable_currency`	예약 금액(결제에 사용된 통화 기준)입니다. `gross_booking_value` 변수 아래에 중첩됩니다. 아래 중첩된 항목을 참조해 주세요.
`billable_currency.currency`	고객이 예약을 결제하는 통화입니다. ISO 4217 형식으로 표시됩니다. `billable_currency` 변수 아래에 중첩됩니다.	GBP
`billable.currency.value`	총 예약 금액입니다. `billable_currency` 변수 아래에 중첩됩니다.	2520.80
`billable_currency.currency`	고객이 세금 및 수수료를 결제하는 통화입니다. ISO 4217 형식으로 표시됩니다. `billable_currency` 변수 아래에 중첩됩니다.	GBP
`billable_currency.value`	고객이 세금 및 수수료로 결제한 금액(청구 통화 기준)입니다. `billable_currency` 변수 아래에 중첩됩니다.	491.10

coupon

필드 이름	정의	예
`code`***	예약에 사용된 쿠폰 코드입니다.	ABCD
`name`***	쿠폰 이름입니다.	PRIME
`description`***	쿠폰에 대한 설명입니다.	BoGo 5%
`currency`***	쿠폰 금액이 적용된 통화입니다. ISO 4217 형식으로 표시됩니다.	GBP
`value`***	쿠폰의 금액입니다.	126.04

*날짜 필드는 협정 세계시(UTC) 기준입니다.

**개인 식별 정보(PII) 데이터입니다. 이 정보는 회사의 지침에 따라 올바르게 처리해야 합니다. 꼭 필요한 경우에만 포함해 주세요.

***이러한 필드의 데이터는 예약이 생성되거나 업데이트된 다음 날 18:00 ~ 20:00(UTC) 사이에 제공됩니다. 현재 실시간에 가까운 데이터는 제공되지 않습니다.

제공 방법

일정 API는 푸시 메커니즘과 풀 메커니즘의 두 가지 방식으로 데이터를 제공합니다.

푸시 메커니즘

푸시 서비스는 핵심 일정 세부 정보를 중심으로 일정 업데이트가 제공되는 대로 거의 실시간으로 전송하도록 설계되었습니다. 이 서비스는 다음과 같은 사용 사례를 대상으로 합니다.

파트너가 자체 웹사이트 또는 앱에 고객의 예약 정보를 표시할 수 있도록 지원
파트너가 예약 관련 상품 및 서비스를 홍보할 수 있도록 지원

이벤트는 HTTP POST 메시지 형식으로 웹훅을 통해 파트너가 제공한 URL에 전달됩니다. 메시지는 순서가 지정되지 않은 상태로 도착할 수 있다는 점에 유의해 주세요. 순서를 정하려면 creation_date및 update_date_time 요소를 참조해 주세요.

인증 절차에 대한 자세한 내용은 시작하기를 참조해 주세요.

풀 메커니즘

풀 서비스는 상세한 일정 데이터를 제공하여 다음과 같은 사용 사례를 지원합니다.

데이터 분석 사용
푸시 전송이 실패한 기간에 대해 데이터 검색 사용
실시간 헬프 데스크 지원 사용

이 서비스는 두 개의 HTTP GET 엔드포인트로 구성되어 있는데, 하나는 지정된 시간대에 생성되거나 업데이트된 일정 목록을 제공하고, 다른 하나는 일정 ID로 해당 일정을 검색합니다. 쿼리 매개변수는 다음과 같습니다.

creation_date_start
creation_date_end
update_date_time_start
update_date_time_end
itinerary_id

인증 절차에 대한 자세한 내용은 시작하기를 참조해 주세요.

API 세부 정보

이 페이지에서 엔드포인트 정의를 살펴본 후 API 테스트 소프트웨어를 사용하여 예시 및 스키마 정의가 실제 출력과 어떤 차이가 있는지 확인해 보세요.