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

Вход через Telegram

Аутентификация по Telegram chat ID. Предназначен для интеграции с Telegram-ботом UChecker.

Как это работает:

  1. Пользователь взаимодействует с Telegram-ботом UChecker.
  2. Бот получает chat_id пользователя и вызывает этот эндпоинт.
  3. Если аккаунт с таким chat_id существует — возвращаются JWT токены и API ключ (аналогично POST /auth/login).

Требования: Аккаунт должен быть предварительно привязан к Telegram через POST /auth/link-telegram или создан через бота. Если аккаунт не найден — возвращается ошибка 400.

Область применения: этот эндпоинт используется внутренним Telegram-ботом и не предназначен для прямого вызова из пользовательских приложений.

post/auth/telegram-login

Request

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

Request body

telegram_idstring required

Telegram chat ID пользователя (числовой, передаётся как строка)

Example request

{
  "telegram_id": "123456789"
}

Response

Успешная аутентификация. Ответ идентичен POST /auth/login.

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.