概览
活动内容丰富且库存对时间敏感。此活动 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 是可预订的变体，例如成人票或套餐。你用它的代码连同出行人组合来下单。
能获取实时预订状态吗？
可以。订阅预订状态事件，出票后即刻收到凭证，无需轮询。