Получение токена доступа

POST /api/auth/token

Назначение

Метод используется для получения токена авторизации, необходимого при интеграции клиентской системы с платформой TEUS Auth.

Перед использованием API необходимо обратиться на терминал для получения отдельной учетной записи, которая будет использоваться исключительно для интеграции.

Пример запроса:

{
  "email": "integration@client.com",
  "password": "securePassword123"
}

Авторизация

Авторизация реализуется по email и паролю через тело запроса (application/json).

Тело запроса

{
  "email": "example@email.com",
  "password": "your_password"
}

Поле

Тип данных

Обязательное

Описание

email

string

✅

Email-адрес учетной записи

password

string

✅

Пароль к учетной записи

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

200 OK

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresInSec": 3600
}

Поле

Тип данных

Описание

token

string

JWT токен доступа

expiresInSec

integer

Время жизни токена в секундах

Описание: Запрос успешно выполнен.

Ошибки

400 Bad Request

{
  "requestId": "f1a12345",
  "timestamp": "2025-07-16T08:46:42.168Z",
  "status": 400,
  "message": "Неверный email или пароль",
  "url": "/api/auth/token",
  "fieldErrors": []
}

Описание: Ошибка валидации входных данных (например, пустой email или пароль, или несуществующий пользователь).

404 Not Found

{
  "requestId": "f1a12345",
  "timestamp": "2025-07-16T08:46:42.170Z",
  "status": 404,
  "message": "Пользователь не найден",
  "url": "/api/auth/token",
  "fieldErrors": []
}

Описание: Указанный пользователь не существует в системе.