Travel API - Документация#

Добро пожаловать в документацию Travel API — единой платформы для работы с туристическими услугами.

О проекте#

Travel API предоставляет унифицированный интерфейс для работы с различными поставщиками авиа, отельных, железнодорожных и трансферных услуг. API скрывает сложность интеграции с множеством GDS и NDC систем, предоставляя единый контракт для всех операций.

Основные возможности#

  • Единый интерфейс — работа со всеми поставщиками через одни и те же эндпоинты
  • Поддержка множества GDS — Amadeus, Galileo, SIG и другие
  • Полный цикл бронирования — от поиска до выписки билетов
  • Управление бронированиями — изменения, обмены, возвраты
  • Дополнительные услуги — багаж, питание, места
  • Управление очередями — работа с GDS очередями

Быстрый старт#

Базовый запрос#

Все операции API используют метод POST и расположены под соответствующими путями:

1POST https://travelplatform.ru/api/avia/search
2Content-Type: application/json
3
4{
5  "originDestinations": [...],
6  "passengers": [...]
7}

Основные эндпоинты#

ОперацияЭндпоинтОписание
Поиск билетов/api/avia/searchПоиск доступных предложений
Создание бронирования/api/avia/pnr_createСоздание PNR из выбранного предложения
Выписка билета/api/avia/ticket_issueОформление билетов для бронирования
Информация о билете/api/avia/ticket_infoПолучение детальной информации о билете

Посмотреть все операции →

Разделы документации#

Операции#

Детальное описание всех операций API с примерами запросов и ответов

Быстрый старт#

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

Окружения#

ОкружениеBase URLНазначение
Testhttps://test.travelplatform.ru/Тестовое окружение для разработки
Productionhttps://travelplatform.ru/Боевое окружение

Важно: Для доступа к API обратитесь к администратору для получения Client ID и Client Secret.

Структура запросов#

Все запросы в Travel API следуют единой структуре:

Обязательные параметры#

Единого набора обязательных полей для всех операций нет. Общие требования:

  • Заголовок Authorization: Bearer {token} — токен, полученный через /api/auth/token
  • Тело запроса в JSON — для операций авиа и отелей; справочники работают по GET с параметрами в URL
  • Параметры операции — состав и обязательность описаны в разделе «Параметры запроса» на странице каждого метода

Поставщик и офис в запросе не передаются: их выбирает сервис по настроенным пресетам клиента.

Структура ответа#

 1{
 2  // Данные ответа (зависят от операции)
 3  "searchId": "...",
 4  "offers": [...],
 5  
 6  // Опциональная секция ошибок
 7  "error": {
 8    "code": "ERROR_CODE",
 9    "message": "Описание ошибки",
10    "description": "Детальное описание"
11  }
12}

Популярные операции#

Поиск авиабилетов#

Самая частая операция — поиск доступных предложений для заданного маршрута:

 1{
 2  "originDestinations": [
 3    {
 4      "odId": "1",
 5      "origin": {
 6        "code": "MOW",
 7        "codeType": "iata",
 8        "type": "city"
 9      },
10      "destination": {
11        "code": "LED",
12        "codeType": "iata",
13        "type": "city"
14      },
15      "departureDate": "2025-12-15"
16    }
17  ],
18  "passengers": [
19    {
20      "ptc": "adt",
21      "quantity": 1
22    }
23  ]
24}

Подробнее о поиске билетов →

Инструменты разработки#

Swagger UI и OpenAPI-схемы доступны только в тестовом окружении — на production они отключены.

  • Postman коллекция — готовые примеры запросов (скоро)

Поддержка#

Возникли вопросы? Свяжитесь с нами:

Примечание: Эта документация описывает production версию API. Для тестирования используйте тестовое окружение.