概覽
活動內容豐富且庫存對時間敏感。此活動 API 提供可搜尋的目錄、已依當地時間濾除過期時段的按日期與時段庫存、簡潔的預訂流程，以及可下載的憑證。
旅遊活動 API 以真實、感知時間的可用性包覆深厚的體驗目錄。類別、語言、時長、價位與依時段的庫存被統一為一個流程，讓你用與機票、飯店相同的程式路徑來販售徒步導覽或一日遊。
你將獲得
1
依城市、類別、價格與語言搜尋目錄。
2
讀取可預訂的日期與時段，皆已依活動當地時間濾除過去時間。
3
建立預訂、確認，並下載憑證。
4
庫存依每個活動的當地時間過濾，已過去的時段絕不顯示。
5
可下載的憑證，以及可訂閱的預訂狀態事件，無需輪詢。
流程如何運作
01
Browse
Search the catalogue by city, category, price, or language.
02
Availability
Read bookable dates, then timeslots for a chosen date.
03
Book
Create a booking for a product-type and traveller mix.
04
Voucher
Confirm and download the voucher, or watch the status event.
主要端點
GET
/Activity/v2/productsSearch the activity catalogue.GET
/Activity/v2/availability/datesList bookable dates for a product.GET
/Activity/v2/availability/timeslotsList timeslots for a chosen date.POST
/Activity/v2/bookingsCreate a booking.GET
/Activity/v2/bookings/{id}/voucherDownload the voucher.請求與回應
Request · GET /Activity/v2/products
GET /Activity/v2/products
?city=Tbilisi
&sort=bestselling
&per_page=20Response · 200 OK
{
"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.
2,500+
全球目的地的活動
常見問題
庫存以什麼形式回傳？
以可預訂的日期，以及所選日期的時段回傳。已過去的部分會依活動當地時間移除。
什麼是 product-type？
產品的一種可預訂變體，例如票種或套裝。你透過它的 id 進行預訂。
何時能取得憑證？
預訂出票後即可取得。你可以監聽預訂狀態事件，而無需輪詢。
product-type 如何運作？
product-type 是可預訂的變體，例如成人票或套裝。你用它的代碼連同出行人組合來下單。
能取得即時預訂狀態嗎？
可以。訂閱預訂狀態事件，開票後立即收到憑證，無需輪詢。