액티비티 콘텐츠는 방대하고 재고는 시간에 민감합니다. 이 액티비티 API는 검색 가능한 카탈로그, 지난 시간이 걸러진 날짜·타임슬롯별 재고, 간단한 예약 흐름, 다운로드 가능한 바우처를 제공합니다.
투어·액티비티 API는 실시간에 가까운 시간 인지형 재고와 함께 깊이 있는 경험 카탈로그를 감쌉니다. 카테고리, 언어, 소요 시간, 가격 등급, 시간대별 재고가 하나의 흐름으로 통합되어, 항공·호텔에 쓰던 같은 코드로 도보 투어나 당일 여행을 판매할 수 있습니다.
제공 기능
도시, 카테고리, 가격, 언어로 카탈로그를 검색하세요.
액티비티 현지 시간을 기준으로 이미 걸러진, 예약 가능한 날짜와 타임슬롯을 확인하세요.
예약을 생성하고 확정한 뒤 바우처를 내려받으세요.
재고는 각 액티비티의 현지 시간 기준으로 필터링되어 지난 시간대는 표시되지 않습니다.
다운로드 가능한 바우처와, 폴링 대신 구독할 수 있는 예약 상태 이벤트를 제공합니다.
흐름은 이렇게 동작합니다
Browse
Search the catalogue by city, category, price, or language.
Availability
Read bookable dates, then timeslots for a chosen date.
Book
Create a booking for a product-type and traveller mix.
Voucher
Confirm and download the voucher, or watch the status event.
주요 엔드포인트
/Activity/v2/productsSearch the activity catalogue./Activity/v2/availability/datesList bookable dates for a product./Activity/v2/availability/timeslotsList timeslots for a chosen date./Activity/v2/bookingsCreate a booking./Activity/v2/bookings/{id}/voucherDownload the voucher.요청과 응답
GET /Activity/v2/products
?city=Tbilisi
&sort=bestselling
&per_page=20{
"products": [
{
"productId": "ACT-4410",
"title": "Old Town Walking Tour",
"durationMinutes": 120,
"from": { "amount": 29.00, "currency": "USD" },
"productTypes": [
{ "code": "ADULT", "label": "Adult ticket" }
]
}
]
}응답에 포함되는 것
productId- Stable id for the activity.
productTypes- Bookable variants, such as ticket tiers or packages.
from- Lead-in price, in USD.
durationMinutes- Length of the experience.
cancellationPolicy- Free-cancellation window, if any.
전 세계 여행지의 액티비티
자주 묻는 질문
재고는 어떻게 반환되나요?
예약 가능한 날짜로, 그리고 선택한 날짜의 타임슬롯으로 반환됩니다. 이미 지난 항목은 액티비티 현지 시간 기준으로 제거됩니다.
product-type이 무엇인가요?
티켓 등급이나 패키지처럼 상품의 예약 가능한 변형입니다. 그 id로 예약합니다.
바우처는 언제 받나요?
예약이 발권되면 받습니다. 폴링 대신 예약 상태 이벤트를 관찰할 수 있습니다.
product-type은 어떻게 동작하나요?
product-type은 성인 티켓이나 패키지 같은 예약 가능한 변형입니다. 여행자 구성과 함께 그 코드로 예약합니다.
실시간 예약 상태를 받을 수 있나요?
네. 예약 상태 이벤트를 구독하면 폴링 없이 예약이 발권되는 즉시 바우처를 받습니다.