Skip to content

Метод обновления токена

Метод /api/v1/refresh предназначен для обновления JWT-токена. Его следует использовать, когда срок действия текущего токена подходит к концу или уже истёк.


URL и Метод

URL:

POST https://verify.promotivation.ru/api/v1/refresh/

HTTP метод:
POST


Заголовки запроса

  • Authorization: Bearer {текущий_токен}
    Передайте в заголовке уникальный токен аутентификации, который необходимо обновить.
  • Content-Type: application/json (если необходимо)

Тело запроса

Тело запроса не требуется. Все данные передаются через заголовки.


Ответ

При успешном обновлении сервер возвращает новый JWT-токен, который необходимо использовать для последующих запросов.

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

{
  "access_token": "новый_токен_пример",
  "token_type": "bearer",
  "expires_in": 3600
}

Коды ответа сервера

  • 200 OK
    Токен успешно обновлён.

  • 401 Unauthenticated
    Неверный токен или токен отсутствует.

  • 403 Forbidden
    Доступ запрещён.

  • 419 Authentication timeout
    Время обновления токена вышло, требуется получить новый токен через /api/v1/login.


Примечания

  • Обновлённый access_token необходимо передавать в заголовке Authorization для всех последующих запросов.
  • При получении ошибки 419 Authentication timeout выполните повторную аутентификацию через метод /api/v1/login.