Rapid Activities API 개요

Rapid Activities API를 통해 여행객들이 다양한 활동과 체험을 예약할 수 있도록 지원하세요

얼리 액세스 미리보기

이 문서는 선별된 파트너만을 대상으로 하는 얼리 액세스 미리보기 프로그램의 일부입니다. 베타 프로그램은 2026년 3분기에 시작되며, 2027년에 정식 출시될 예정입니다.

베타 파트너가 되는 데 관심이 있으시면 담당 계정 관리자에게 문의해 주시기 바랍니다.

Rapid Activities API는 통합이 용이한 ‘ end-to-end ’ 쇼핑 및 예약 절차를 통해 여행객에게 액티비티 정보를 제공할 수 있도록 설계되었습니다. 이를 통해 여행객들에게 더욱 포괄적인 경험을 제공함과 동시에 새로운 수익원을 창출할 수 있게 됩니다.

핵심 개념

기간	정의
즐길거리	예약 가능한 이벤트(전시 및 판매 대상).
활동 그룹	비슷한 활동들이 한데 묶인 것.
경험	여러 활동을 포함할 수 있는 개념적/마케팅적 틀.
티켓	활동별 예약 유형(성인/어린이/영유아 등).
일정	하나의 활동과 하나 이상의 티켓으로 구성된 예약(활동 예약).
카테고리	High-level 체험과 활동을 주제별로 분류한 그룹(예: 시내 관광, 박물관, 야외 활동 등).
속성	특정 체험이나 활동의 구체적인 특징을 나타내는 설명형 태그(예: 휠체어 이용 가능, “가족 동반 가능”, “가이드 투어”, “대기 줄 건너뛰기” 등).

종단 간 통합 흐름

이 API를 사용하여 활동을 예약하는 절차는 다음과 같은 일반적인 흐름을 따릅니다.

1단계: 재고 파악하기

먼저, 판매에 바로 활용할 수 있도록 목적지별로 체계적으로 정리된 활동 목록을 작성하는 것부터 시작하세요. 이 카탈로그를 통해 해당 지역에서 판매할 수 있는 상품이 무엇인지 파악하는 데 도움이 될 것입니다.

카탈로그 설정하기

region-mapping 엔드포인트를 사용하여 지리적 지역을 기본 재고(체험, 활동 및 활동 그룹)에 매핑합니다. 참고: 이번 버전에서는 Activities API가 ‘ region_ID ’ 매개변수만 지원합니다.
>> 지역에 대한 자세한 정보 보기
다양한 언어로 된 풍부한 활동 콘텐츠(제목, 설명, 이미지, 위치, 카테고리)를 가져옵니다.
여행자들이 다양한 옵션을 비교하고 해당 체험에 대한 신뢰를 쌓을 수 있도록, 각 활동에 대한 게스트 평점과 리뷰를 수집하세요.
검색 결과, 활동 상세 페이지 및 필터(예: “가족 동반 가능” 또는 “도보 투어”)에 내용을 채워 넣습니다.

지역 및 면적별 필터링

Rapid Activities API를 사용하면 area 쿼리 매개변수를 통해 결과를 필터링하여, region_id 및 area 좌표로 정의된 구역의 교집합 내에서 탐색할 수 있습니다. 이는 사용자 정의 필터링 로직을 줄이고, 호텔과 같은 특정 지점 근처에서 이루어지는 여행객들의 활동을 표시하는 데 도움을 드리기 위한 것입니다.

area필터를 사용하려면, 반환할 활동의 지리적 범위를 나타내는 radius_km, latitude 및 longitude 필드를 해당 필터에 포함시켜야 합니다.

요청 예

GET /v2/regions/{region_id}/activity-groups?area=10,34.0512226,-118.2403994&pagination_size=25

참고: radius_km ( area 내의 첫 번째 필드)는 0 이상인 정수여야 합니다.

2단계: 예약 가능 여부와 가격 확인하기

어떤 활동이 언제 이용 가능한지, 그리고 요금은 얼마인지 확인하세요. 예약 가능한 날짜/시간, 티켓 옵션, 가격대를 활용하여 쇼핑 여정을 원활하게 이끌어 주세요.

구체적인 활동 내용 및 일정에 대해서는 티켓 종류별로 이용 가능 여부와 요금을 문의해 주시기 바랍니다.
쇼핑객 화면에서 달력(예약 가능/불가능한 날짜), 시간대 및 시작 가격을 표시합니다.
단일 호출에서 여러 활동을 지원합니다.

3단계: ‘ Pre-booking ’ 가격 확인

결제 전에 최종 예약 가능 가격을 확인하고, 예약 시 필수 입력 항목 목록을 확인하세요. 최신 재고 현황 및 정책에 따라 확정된 제안과 예약 토큰을 받으세요.

특정 선택 사항(활동, 날짜, 시간 및 티켓)을 실시간으로 검증합니다.
최종 가격, 세금/수수료 및 재고 현황(가격 변동 또는 품절 포함)을 확인하세요.
예약에 필요한 항목(예: 승객 정보 또는 pick-up 유형 등)에 대한 세부 정보와 예약용 보안 토큰을 확인하세요.

4단계: 예약 생성

확정된 선택을 예약으로 전환하세요. 자사 시스템에서 표시하고 관리할 수 있는 확인된 일정(예약) 정보를 수신하세요.

쇼핑 흐름에서 생성된 예약 토큰을 쿼리 매개변수로, Payments API에서 반환된 예약 ID( payment_token)를 요청 본문에 여행자 정보(주 여행자 및 추가 여행자)와 함께 포함시켜 전송하십시오.
나중에 예약 내역을 대조하고 검색할 수 있도록 본인의 제휴사 참조 번호를 기재해 주세요.
일정 ID와 예약 내역을 확인할 수 있는 링크를 받아보세요.

5단계: 예약 관리

고객과 상담원을 위한 예약 후 업무 흐름을 지원합니다. 예약 완료 후 사용할 수 있는 종합 도구 모음을 활용하여 기존 예약을 조회하고, 취소하며, 바우처를 발급할 수 있습니다.

일정 ID 또는 제휴사 참조번호를 통해 예약 내역을 조회하세요.
허용되는 경우 예약을 취소하고, 그 결과 상태를 고객에게 알립니다.
고객이 행사 현장에서 제시할 수 있도록 바우처 서류를 준비해 주세요.

환불 가능 요금

Rapid Activities API는 ‘환불 가능 비율(Refundable Rate)’ 속성을 기준으로 활동을 필터링하여, 지정된 취소 기간 내에 취소할 경우 환불이 가능한 활동을 표시할 수 있도록 지원합니다. 이 기능은 맞춤형 필터링 로직의 필요성을 줄이고, 더 유연한 취소 정책을 적용하는 여행 상품을 여행객에게 보여주기 위해 마련되었습니다.

환불 가능한 활동 필터링

환불 가능한 요금제의 경우, 속성 ID 25와 함께 ‘ attribute_id ’ 매개변수를 사용하십시오.

GET /v2/regions/{region_id}/activities?attribute_id=25

참고: 여행객에게 취소 약관을 안내할 때는 응답에 포함된 정책 정보를 계속해서 활용해야 합니다.

요청 예

GET /experiences/activities/content?language=en-US&activity_id=703295&activity_id=973888&activity_id=975441&activity_id=1006352&supported_booking_data_types=*&attribute_id=25

오류 응답 테스트

특정 Rapid Activities API 메서드에 대한 테스트 요청을 보내려면, 쇼핑 또는 예약 요청에 ‘ test ’라는 추가 HTTP 헤더를 포함시키고 아래 표에 있는 적절한 값을 사용하십시오. 테스트 헤더를 전송하지 않거나 유효하지 않은 테스트 헤더를 전송할 경우, 해당 요청은 실제 처리로 진행됩니다.

참고: 테스트 헤더를 사용하면 정적 메시지가 반환되므로, 반환되는 요금 및 콘텐츠가 테스트 중인 활동과 관련이 없을 수 있습니다.

쇼핑 및 콘텐츠 API

테스트 헤더 값	HTTP 코드 및 응답	상태
표준형	200 OK (표준 성공 응답)	성공
`bad_link`	400 잘못된 요청 (잘못된 링크)	오류
`invalid_input`	400 잘못된 요청 (잘못된 입력)	오류
`internal_server_error`	500 내부 서버 오류 (알 수 없는 오류)	오류
`service_unavailable`	503 서비스가 제공되지 않습니다	오류

예약 API

테스트 헤더 값	HTTP 코드 및 응답	상태
표준형	200 OK (표준 성공 응답)	성공
`bad_link`	400 잘못된 요청 (잘못된 링크)	오류
`invalid_input`	400 잘못된 요청 (잘못된 입력)	오류
`price_mismatch`	409 오류 (가격 불일치)	오류
`sold_out`	410 콘플릭트 (매진)	오류
`internal_server_error`	500 내부 서버 오류 (알 수 없는 오류)	오류
`service_unavailable`	503 서비스가 제공되지 않습니다	오류

API 세부 정보

이 페이지에서 activity-related 엔드포인트 정의를 살펴본 다음, Postman과 같은 테스트 소프트웨어를 사용하여 예시와 스키마 정의가 실제 출력 결과와 어떻게 다른지 확인해 보세요. 이 API가 시범 운영 단계를 마치면, 해당 엔드포인트는 당사의 API Explorer 에도 포함될 예정입니다.