Skip to content

Авторизация

##Авторизация в системе

INFO

Авторизация в системе

POST v2/login Метод авторизации
http
https://client.adstat.pro/api/v2/login

Request body FormData

ПараметрТипОписание
usernamestringЛогин пользователя
passwordstringПароль пользователя

Content-Type:

  • application/x-www-form-urlencoded
  • multipart/form-data

Request:

username=user@example.com
password=string

Response:

json
{
  "user_id": "3fa85f64-5717-4562-b3fc-2c922263f66a",
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
  "refresh_token": "dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4gdXNlZCB0byBnZXQgYW4gbmV3IGFjY2VzcyB0b2tlbiB3aGVuIHRoZSBjdXJyZW50IGFjY2VzcyB0b2tlbiBleHBpcmVz"
}

<access_token> необходимо передавать в headers HTTP запросов в формате:

  • Bearer <access_token>

<refresh_token> необходимо использовать в методе v2/access_token, когда истёк срок действия <access_token> - для обновления <access_token>

Выписка нового токена access_token

INFO

Выписка нового токена access_token

GET v2/access-token

Пример использования:

http
https://client.adstat.pro/api/v2/access-token

Параметры

В заголовке HTTP запроса необходимо передать <refresh_token> в формате:

  • refresh_token: <refresh_token>

Пример успешного ответа:

json
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
  "token_type": "Bearer"
}

Срок действия и ошибки

refresh_token автоматически деактивируется через 30 дней после выдачи.

Если при попытке обновления токена система не находит активный refresh_token (например, он истёк или был деактивирован), возвращается ошибка:

json
{
  "detail": "Refresh Token Expired",
  "status_code": 401
}

В этом случае пользователю необходимо повторно пройти аутентификацию (выполнить вход), чтобы получить новые access_token и refresh_token.