POST /auth/refresh
Troque um refresh_token por um novo par de access_token e refresh_token. Utilize este endpoint quando o token de acesso atual tiver expirado.
Este endpoint não requer autenticação.
Corpo do pedido
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
refresh_token | string | Sim | O refresh token obtido via POST /auth/login ou numa renovação anterior |
Pedido
curl -X POST https://api.dokstamp.eu/auth/refresh \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{ "refresh_token": "def50200a9c4b..." }'
Resposta 200
{
"access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...",
"refresh_token": "def50200newtoken...",
"token_type": "Bearer",
"expires_in": 31536000
}
O refresh_token antigo é invalidado após a utilização. Guarde sempre o novo refresh_token devolvido nesta resposta.
Erro 401
{ "message": "The refresh token is invalid." }