Структура ответа#
Детальное описание структуры ответа от /auth/token.
Основная структура#
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
token | string | Нет | JWT токен доступа |
expiresAt | string | Нет | Время истечения токена в формате ISO 8601 (UTC) |
error | Error | Нет | Информация об ошибке (присутствует только при ошибке) |
Успешный ответ#
При успешной аутентификации возвращаются поля token и expiresAt:
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
token | string | Да | JWT токен доступа для использования в последующих запросах |
expiresAt | string | Да | Дата и время истечения токена в формате ISO 8601 (UTC) |
Пример успешного ответа#
1{
2 "token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJxWXo4...",
3 "expiresAt": "2025-12-29T12:00:00Z"
4}Поле token#
JWT токен доступа для использования в заголовке Authorization: Bearer {token} при всех запросах к API.
Поле expiresAt#
Время истечения токена в формате ISO 8601 (UTC). После этого времени токен становится недействительным и необходимо получить новый.
Примеры формата:
2025-12-29T12:00:00Z2025-12-29T12:00:00.000Z
Ответ с ошибкой#
При ошибке аутентификации API возвращает HTTP 401 Unauthorized с полем error в теле ответа.
Пример#
1{
2 "error": {
3 "code": "AUTHENTICATION_FAILED",
4 "message": "Authentication failed",
5 "description": null,
6 "errorId": "018c5f2e-9b3a-7f4d-8e2c-1a2b3c4d5e6f"
7 }
8}Коды ошибок#
| Код | Описание | Причина |
|---|---|---|
AUTHENTICATION_FAILED | Ошибка аутентификации | Неверные clientId или clientSecret |
Использование токена#
После получения токена используйте его в заголовке Authorization для всех запросов к API:
1curl -X POST https://test.travel-api.ru/avia/search \
2 -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJxWXo4..." \
3 -H "Content-Type: application/json" \
4 -d '{ ... }'HTTP статус коды#
| Статус | Описание |
|---|---|
200 OK | Успешная аутентификация |
401 Unauthorized | Ошибка аутентификации (подробности в поле error в теле ответа) |