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에서 반환된 payment_token 를 요청 본문에 여행자 정보(주 여행자 및 추가 여행자)와 함께 포함시켜 전송하십시오.
나중에 예약 내역을 대조하고 검색할 수 있도록 본인의 제휴사 참조 번호를 기재해 주세요.
일정 ID와 예약 내역을 확인할 수 있는 링크를 받아보세요.

5단계: 예약 관리

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

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

마케팅 수수료 및 매출 총이익

Rapid Activities API를 사용하면 marketing_fee 및 gross_profit 의 예상 수익 데이터를 조회하여 거래에 대한 예상 수익을 파악할 수 있습니다.

marketing_fee 이는 해당 거래에 대한 귀하의 예상 파트너 수익으로, 귀하와 [상대방] 간의 상업적 조건에 따라 미리 산출된 총이익의 지분입니다. Expedia Group
gross_profit이는 귀하와 Expedia Group; 간에 분배될 것으로 예상되는 총 수익입니다. 원하신다면, ‘ marketing_fee ’ 대신 이 필드를 사용하여 자체적인 티어 논리를 적용할 수 있습니다.

두 필드 모두 ‘가용성’, ‘가격 조회’ 및 ‘조회’ 응답에 포함되어 반환되며, 가용성이 확인된 이후 발생한 가격 변동을 반영하기 위해 ‘가격 조회’ 단계에서 재계산됩니다. Retrieve 응답은 예약의 최신 재무 상태를 반영하므로, 해당 상태가 변경된 경우 그 값이 가격 확인 시 표시된 내용과 다를 수 있습니다.

Rapid API 구현에 Expedia Affiliate Collect(EAC) 가 활성화된 경우, ‘가용성 및 가격 조회’ 응답에 marketing_fee_eac 도 표시됩니다. 이는 ‘ EAC ’ 지급 경로에 따른 예상 소득을 나타냅니다. Retrieve 응답은 예약 완료에 실제로 사용된 결제 경로와 일치하는 필드를 반환합니다.

원하신다면 이 세 가지 매개변수에 대한 접근 권한을 모두 설정할 수 있습니다. 이 기능을 활성화하고 싶으시면 담당 계정 관리자에게 문의해 주십시오.

환불 가능 요금

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는 이제 예약에 영향을 미치는 이벤트에 대한 푸시 알림을 지원하므로, 폴링 없이도 귀사의 시스템이 Rapid API 과 항상 최신 상태를 유지할 수 있습니다.

오프라인 예약 취소: 에서 Rapid API 고객 지원 담당자가 활동 예약을 취소할 경우, itinerary.agent.cancel 을 통해 알려드립니다.
Supplier-initiated 취소: 는 itinerary.supplier.cancel 를 통해 활동 제공업체가 예약을 취소할 때 알림을 보내므로, 귀사는 Retrieve 호출을 기다릴 필요 없이 여행자에게 이를 알리고 시스템을 업데이트할 수 있습니다.

각 알림은 Rapid Lodging API에서 사용되는 것과 동일한 이벤트 스키마를 따르는 JSON 본문이 포함된 HTTPS POST 형식으로 전송됩니다: event_id, event_type, event_time, itinerary_id, email, message 및 affiliate_reference_id.

각 이벤트 유형별로 개별적으로 활성화해야 합니다.

>> 알림에 대해 더 알아보기

오류 응답 테스트

특정 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 에도 포함될 예정입니다.