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

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

О проекте#

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

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

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

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

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

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

1POST https://travel-api.ru/avia/search
2Content-Type: application/json
3
4{
5  "originDestinations": [...],
6  "passengers": [...],
7  "officeId": "YOUR_OFFICE_ID",
8  "supplier": "amadeus"
9}

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

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

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

Операции#

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

Сценарии использования#

Примеры типичных бизнес-процессов от начала до конца

Окружения#

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

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

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

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

Каждый запрос должен содержать:

• officeId — идентификатор офиса в системе поставщика
• supplier — код поставщика (amadeus, galileo, sig и т.д.)
• Специфичные для операции параметры

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

 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      "paxType": "adt",
21      "quantity": 1
22    }
23  ],
24  "officeId": "MOWG12345",
25  "supplier": "amadeus"
26}

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

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

• Swagger UI — интерактивная документация:

  TEST

  • Auth API
  • Avia API

  PROD

  • Auth API
  • Avia API

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

Поддержка#

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

• Email: support@travelplatform.ru

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