신속한 활동 API 파일럿 문서
얼리 액세스 미리 보기
이 문서는 일부 파트너에게만 제공되는 얼리 액세스 미리 보기 이니셔티브의 일부입니다. 파일럿 프로그램은 2025년 3분기까지 시작되며, 2026년에 정식 출시될 예정입니다.
파일럿 또는 베타 파트너가 되고 싶다면 담당 계정 관리자에게 문의하세요.
최근의 증거()에 따르면 여행객들은 점점 더 물질적 소유보다 진정한 경험을 추구하고 있으며, 예전에도 pre-Covid, 그랬지만 post-pandemic 세상에서는 더더욱 그러합니다. 신속한 활동 API는 파트너가 손쉽게 통합할 수 있는 end-to-end 예약 경로를 통해 고객에게 활동과 경험을 제공할 수 있도록 설계되었습니다. 이를 통해 고객에게는 보다 종합적인 예약 경험을 제공하고 파트너에게는 새로운 수익원을 창출할 수 있습니다.
Rapid /액티비티 API 번들
신속한 활동은 search-to-book 흐름을 가능하게 하는 다양한 엔드포인트로 구성되어 있습니다.
이 제품은 아직 얼리 액세스 단계이므로 스키마 세부 사항과 기능은 아직 개발 중이며 파트너에게 정식 출시되기 전에 변경될 수 있다는 점을 염두에 두시기 바랍니다.
다음은 관련된 주요 엔드포인트입니다:
| 조치 | 메서드 | 휴식 URI | 결과 |
|---|---|---|---|
| 활동 검색 | GET | /활동/가용성 | 지정된 위치와 날짜 범위를 기준으로 사용 가능한 액티비티와 체험을 검색합니다. |
| 세부 정보 보기 | GET | /활동/{activity_id}/offers | 선택한 액티비티에 대한 오퍼를 찾습니다. 특정 액티비티에 대해 이용 가능한 투어 등의 시간과 가격을 반환합니다. |
| 가격 확인 | GET | /활동/{activity_id}/offers/{offer_id} | 요약된 가격과 필수 예약 필드를 반환합니다. |
| 예약 결제 수단 등록하기 | POST | /결재 | 예약 시 결제 수단을 등록합니다. 응답에는 예약 생성 요청 본문에 payment_token주소가 포함됩니다. |
| 예약 만들기 | POST | /일정/activity | 예약을 생성합니다. 이 엔드포인트는 관련 작업 링크가 포함된 itinerary_id을 반환합니다. |
| 기존 예약의 세부 정보를 일정 ID로 요청하세요. | GET | /일정/{itinerary_id}/activity | itinerary_id파라미터로 일정 세부 정보를 반환합니다. |
| 액티비티 벤더별 기존 예약의 세부 정보를 요청합니다. | GET | /일정/activity | affiliate_reference매개변수를 기준으로 예약의 세부 정보를 반환합니다. |
| 예약 취소 | 삭제 | /일정/{itinerary_id}/activity | 기존 예약을 취소합니다. |
사용 사례
신속한 활동 API를 사용하여 고객을 위한 end-to-end 예약 환경을 만드는 방법은 다음과 같습니다.
1단계 - 원하는 위치에서 이용 가능한 액티비티 및 체험 검색하기
/activities/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 |
2단계 - 원하는 액티비티에 대해 이용 가능한 오퍼의 세부 정보를 확인합니다.
선택한 활동에 사용할 수 있는 오퍼에 대한 자세한 정보를 고객에게 제공합니다. /activities/{activity_id}/offers 엔드포인트는 투어와 같은 액티비티의 이용 가능한 시간과 가격을 반환합니다.
여행자가 예약하기 전에 알아두어야 할 세부 정보는 다음과 같습니다:
| 엔드포인트 | 다음 용도로 사용하세요... |
|---|---|
callouts | 예약 전에 고객에게 액티비티에 대해 알아야 할 중요한 정보를 제공하세요. |
inclusions | 활동에 포함된 모든 기능에 대한 개요를 제공합니다. |
exclusions | 활동에 포함되지 않은 기능의 목록을 입력합니다. |
3단계 - 가격 확인 및 결제 세부 정보 제공
고객이 완벽한 휴가 경험을 찾았다면 /activities/{activity_id}/offers/{ {offer_id} 엔드포인트를 사용하여 현재 가격 및 필수 예약 정보를 확인합니다.
4단계 - 고객이 선택한 결제 방법에 대한 정보 얻기
이제 /payments 엔드포인트를 사용하여 고객이 예약에 대한 결제 수단을 등록할 수 있습니다. 응답에는 예약 생성 요청의 본문에 포함된 payment_token이 포함됩니다.
5단계 - 예약 만들기
/일정/activity 엔드포인트를 사용하여 예약을 생성합니다. 이 엔드포인트는 모든 관련 작업 링크가 포함된 itinerary_id을 반환합니다.
6단계 - 예약 세부 정보 검색
/일정/{itinerary_id}/activity 엔드포인트를 사용하여 일정 ID를 사용하여 예약 세부 정보를 검색할 수 있습니다. 응답에는 해당되는 경우 취소 링크가 포함됩니다.
API 세부 정보
이 페이지의 activity-related 엔드포인트 정의를 살펴본 다음 테스트 소프트웨어를 사용하여 예제와 스키마 정의가 실제 출력과 어떻게 비교되는지 파악하세요. 이 API가 파일럿 단계를 지나면 해당 엔드포인트는 API Explorer 에도 포함될 예정입니다.