Метод обновления токена¶
Метод /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.