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

Вход по email и паролю

Аутентификация по email и паролю. При успешном входе возвращает набор данных для работы с API.

Что возвращается:

  • access_token — JWT токен для аутентификации запросов (время жизни: 1 час). Передавайте в заголовке Authorization: Bearer <token>.
  • refresh_token — токен для обновления access_token (время жизни: 7 дней). Используйте POST /auth/refresh.
  • api_key — персональный API ключ для программного доступа. Не истекает.
  • user — информация об аккаунте.

Рекомендация: Для серверных интеграций используйте API ключ (x-api-key) вместо JWT — это проще и не требует логики обновления токенов. JWT подходит для фронтенд-приложений, где нужна сессия с ограниченным временем жизни.

post/auth/login

Request

  • Base URL: https://api.uchecker.net
  • URL: https://api.uchecker.net/auth/login
  • Auth: none declared

Request body

emailstring required

Email-адрес, указанный при регистрации

passwordstring required

Пароль аккаунта

language'ru' | 'en'

Язык интерфейса, в котором пользователь работает. На нём же ему пишут письма жизненного цикла.

Example request

{
  "email": "user@example.com",
  "password": "password123",
  "language": "ru"
}

Response

Успешная аутентификация. Ответ содержит JWT токены, API ключ и данные аккаунта.

api_keystring required

Персональный API ключ. Используйте в заголовке x-api-key для аутентификации запросов. Не имеет срока действия.

access_tokenstring required

JWT access token. Время жизни: 1 час. Передавайте в заголовке Authorization: Bearer <token>.

refresh_tokenstring required

JWT refresh token. Время жизни: 7 дней. Используйте для обновления access token через POST /auth/refresh.

Example response

{
  "user": {
    "id": 1,
    "email": "user@example.com",
    "telegram_code": 123456
  },
  "api_key": "uk_xxxxxxxxxxxxx",
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "refresh_token": "eyJhbGciOiJIUzI1NiIs..."
}

Changes

No recorded changes to this operation across all 1 revision of this API.