빠른 활동 API 개요

얼리 액세스 미리 보기

이 문서는 일부 파트너에게만 제공되는 얼리 액세스 미리 보기 이니셔티브의 일부입니다. 파일럿 프로그램은 2025년 4분기에 시작되며, 2026년에 정식 출시될 예정입니다.

파일럿 또는 베타 파트너가 되고 싶다면 담당 계정 관리자에게 문의하세요.

신속한 액티비티 API는 간편하게 통합할 수 있는 end-to-end 예약 경로를 통해 여행자에게 액티비티와 체험을 노출할 수 있도록 설계되었습니다. 이를 통해 여행자에게 보다 종합적인 예약 경험을 제공하는 동시에 새로운 수익원을 확보할 수 있습니다.

아래에 설명된 단계는 액티비티 API와 통합하고 예약 경로를 구축하는 방법에 대한 개요입니다. 신속한 활동 API는 search-to-book 플로우를 활성화하는 다양한 엔드포인트로 구성되어 있습니다.

참고: 이 제품은 아직 얼리 액세스 단계이므로 스키마 세부 사항과 기능은 아직 개발 중이며 파트너에게 정식 출시되기 전에 변경될 수 있다는 점을 염두에 두시기 바랍니다.

availability엔드포인트는 지정된 위치 및 날짜 범위를 기준으로 사용 가능한 활동 및 경험을 검색합니다.

아래의 주요 매개변수를 살펴보세요:

주요 매개 변수	설명	추천
`start_date`	사용 가능한 활동을 검색할 수 있는 시작일입니다.	ISO 8601 형식을 사용합니다. 예를 들어, 2018-02-12.
`end_date`	사용 가능한 활동을 검색할 수 있는 종료일입니다.	ISO 8601 형식을 사용합니다. 예를 들어, 2018-02-12.
`currency`	요금에 대한 요청 통화입니다.	ISO 4217 형식을 사용합니다. 예: USD.
`language`	응답에 사용할 언어입니다.	코드는 ISO639-1 alpha 2 언어 코드와 ISO3166-1 alpha 2 국가 코드만 사용합니다.
`country_code`	여행자의 판매 시점의 국가 코드입니다.	ISO 3166-1 알파-2 형식을 사용합니다. 구매 거래가 이루어지는 국가를 나타내야 합니다. 예를 들어, 미국.
`region_id`	여행자가 액티비티를 찾고 있는 위치 또는 지역입니다.	예를 들어, 1122931.
`limit`	응답에서 반환된 최대 활동 수입니다.	최대: 100

offers엔드포인트는 여행자가 선택한 액티비티에 대해 시간, 가격, 투어 이용 가능 여부 등 어떤 혜택을 이용할 수 있는지에 대한 자세한 정보를 제공합니다.

여행자가 예약하기 전에 알아두어야 할 세부 정보는 다음과 같습니다:

엔드포인트	다음 용도로 사용하세요...
`callouts`	예약 전에 고객에게 액티비티에 대해 알아야 할 중요한 정보를 제공하세요.
`inclusions`	활동에 포함된 모든 기능에 대한 개요를 제공합니다.
`exclusions`	활동에 포함되지 않은 기능의 목록을 입력합니다.