Авторизация пользователя

POST /user/login

Описание

Метод используется для авторизации пользователя по email и паролю. При успешной аутентификации возвращается временный JWT-токен доступа.

Токен действует 7 дней, если для учётной записи не задан другой срок. Продлить токен нельзя: когда срок истечёт, выполните вход снова и получите новый токен. Срок действия токена в запросе не задаётся.

Формат запроса

  • HTTP метод: POST
  • URL: /user/login
  • Тип контента: application/json
  • Авторизация: не требуется

Параметры запроса

ПараметрТипОбязательныйОписание
emailstring✅Email-адрес пользователя
passwordstring✅Пароль пользователя

Как использовать токен

Все методы API вызываются запросом POST; запрос на неизвестный путь вернёт 405. Полученный токен передавайте в заголовке token: <jwt-token>. Вместо него можно передать постоянный API-токен в поле token тела запроса. Без действующего токена методы отвечают 401 access denied.

Пример запроса (cURL)

curl -X POST "https://api.neuro-vision.ru/v1/user/login" -H "Content-Type: application/json" -d '{"email": "user@example.com", "password": "password"}'

Примеры ответов

Успех (200 OK)

{
  "status": "ok",
  "token": "<jwt-token>"
}

Ошибка (400 Bad Request)

{
  "message": "invalid schema",
  "status": "error"
}

Ошибка (403 Forbidden)

Неверный email или пароль. Поле status в этом ответе равно "ok", поэтому отказ определяйте по HTTP-коду 403.

{
  "status": "ok",
  "message": "access denied"
}