Saltar para o conteúdo principal

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âmetroTipoObrigatórioDescrição
refresh_tokenstringSimO 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." }