API активностей

Туры, достопримечательности и впечатления

Просматривайте каталог, проверяйте доступность по датам и таймслотам, бронируйте и выдавайте ваучер. Единый REST-поток, цены в USD.

Справочник APIЧитать гайд
GET /Activity/v2/products
GET /Activity/v2/products
  ?city=Tbilisi
  &sort=bestselling
  &per_page=20
Обзор

Контент активностей обширен, а доступность чувствительна ко времени. Этот 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=20
Response · 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.
2500+

Активностей в направлениях по всему миру

Частые вопросы

Как возвращается доступность?

В виде доступных дат и таймслотов для выбранной даты. Всё, что уже прошло, удаляется по местному времени активности.

Что такое product-type?

Бронируемый вариант продукта, например уровень билета или пакет. Вы бронируете по его id.

Когда я получу ваучер?

Как только бронь выписана. Вместо опроса можно слушать событие статуса брони.

Как работают product-type?

Product-type задаёт бронируемый вариант, например взрослый билет или пакет. Вы бронируете по его коду вместе с составом путешественников.

Можно ли получать статус брони в реальном времени?

Да. Подпишитесь на событие статуса брони и получите ваучер сразу после выписки, без опроса.

Продолжайте изучать

API авиабилетов

Поиск и бронирование авиабилетов от начала до конца

API отелей

Поиск отелей, тарифы и бронирование

Справочник API

Один запрос для старта

Соберите свой тревел-продукт на одном API.

Интеграция бесплатна. 1% за выписанный билет, не более $10. Живое покрытие авиабилетов, отелей и активностей.

Читать документациюСвязаться с отделом продаж