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

Получите первый успешный ответ от Travel API за 5 минут.

Что вы получите#

К концу этого руководства вы:

  • Получите аутентификационный токен
  • Сделаете первый запрос к API
  • Поймете базовую структуру запросов и ответов

Что вам понадобится#

  • Client ID и Client Secret - получите у вашего менеджера
  • HTTP клиент - curl, Postman, или любой другой

Нет доступа? Обратитесь к вашему менеджеру для получения Client ID и Client Secret. Email: support@travelplatform.ru

Шаг 1: Получение токена (30 секунд)#

Все запросы к Travel API требуют аутентификации через Bearer токен. Сначала получим его.

Запрос#

1curl -X POST https://test.travelplatform.ru/auth/token \
2  -H "Content-Type: application/json" \
3  -d '{
4    "clientId": "your-client-id",
5    "clientSecret": "your-client-secret"
6  }'

Успешный ответ#

1{
2  "token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
3}

Ответ с ошибкой#

1{
2  "error": {
3    "code": "AUTHENTICATION_FAILED",
4    "message": "Authentication failed",
5    "errorId": "018c5f2e-9b3a-7f4d-8e2c-1a2b3c4d5e6f"
6  }
7}

Шаг 2: Первый запрос к API (2 минуты)#

Теперь используем токен для поиска авиабилетов Москва → Санкт-Петербург.

Запрос#

 1curl -X POST https://test.travelplatform.ru/avia/search \
 2  -H "Content-Type: application/json" \
 3  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
 4  -d '{
 5    "originDestinations": [
 6      {
 7        "odId": "1",
 8        "origin": {
 9          "code": "MOW",
10          "codeType": "iata",
11          "type": "city"
12        },
13        "destination": {
14          "code": "LED",
15          "codeType": "iata",
16          "type": "city"
17        },
18        "departureDate": "2025-12-15"
19      }
20    ],
21    "passengers": [
22      {
23        "paxType": "adt",
24        "quantity": 1
25      }
26    ]
27  }'

Успешный ответ (сокращенно)#

 1{
 2  "searchId": "6FBC2E65528BFD16CAD20472AF493554",
 3  "offers": [
 4    {
 5      "offerId": "52BE8B4712617B39F8B7ED22A03AE145",
 6      "legs": [
 7        {
 8          "segments": [
 9            {
10              "segmentId": "FA83FB7DC5CADD80D073608CA35333B2",
11              "flightId": "SU1105MOW-LED151220252225",
12              "stopQuantity": 0
13            }
14          ],
15          "totalDuration": "01:25:00"
16        }
17      ],
18      "offerItems": [
19        {
20          "offerItemId": "2D16A846EBCF9944E5E4CF61608E031C",
21          "totalAmount": {
22            "currencyCode": "RUB",
23            "value": 5500
24          },
25          "fareAmount": {
26            "currencyCode": "RUB",
27            "value": 4200
28          },
29          "taxAmount": {
30            "currencyCode": "RUB",
31            "value": 1300
32          }
33        }
34      ],
35      "validatingCarrier": "SU"
36    }
37  ]
38}

Успешно! Вы получили список доступных рейсов. Значение searchId используется для следующих шагов (выбор тарифа, бронирование).

Шаг 3: Что делать дальше#

Теперь вы готовы использовать Travel API. Типичные следующие шаги:

Изучите операции API#

  1. Поиск билетов - детальная документация поиска с фильтрами
  2. Создание бронирования - как создать PNR из выбранного предложения
  3. Выписка билета - оформление билетов

Попробуйте практические сценарии#

Возможные проблемы#

Ошибка аутентификации#

1{
2  "error": {
3    "code": "AUTHENTICATION_FAILED",
4    "message": "Authentication failed"
5  }
6}

Причины:

  • Неверный Client ID или Client Secret
  • Клиент заблокирован или не активен

Решение: Проверьте учетные данные или обратитесь к администратору

Ошибка “Unauthorized” (401)#

HTTP/1.1 401 Unauthorized

Причины:

  • Не указан заголовок Authorization
  • Токен истек (прошло более 24 часов)
  • Неверный формат токена

Решение: Получите новый токен через /auth/token

Ключевые моменты#

Запомните:

  1. Все запросы к /avia/ требуют токен в заголовке Authorization: Bearer {token}
  2. Даты в формате ISO 8601 - YYYY-MM-DD или YYYY-MM-DDTHH:MM:SS
  3. Все ответы содержат поле error - если null, запрос успешен

Нужна помощь?#

Следующие шаги#

Аутентификация#

Подробнее о получении токенов и сроках действия

Окружения#

Production vs Test, различия и когда что использовать

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

Полная документация операции поиска с примерами

Бронирование#

Как создать бронирование из найденного предложения

Готовы? Начните с детальной документации операций или попробуйте практические сценарии!

Операции Forward