POST/api/auth/refresh

Troca um token de atualização válido por um novo par de token de acesso e token de atualização.

Envie o `refreshToken` recebido mais recentemente no corpo JSON. A resposta contém um novo `token` e um novo `refreshToken`. Cada token de atualização só pode ser usado uma vez e é válido por sete dias por predefinição; guarde o novo token após cada chamada e descarte o antigo. Um token de atualização em falta, inválido, expirado ou já usado resulta em 400 `VALIDATION_ERROR`. O utilizador terá então de voltar a iniciar sessão através de `POST /api/auth/login`. Como um token de atualização é consumido ao ser usado, um cliente deve evitar renovações paralelas.

Visão geral

Chamada: POST /api/auth/refresh. Este endpoint pertence ao grupo «Autenticação» da API da Zentor App. É de acesso público e não requer autenticação. A chamada não é idempotente: cada chamada bem-sucedida volta a desencadear a ação. Parâmetros obrigatórios: refreshToken (body). Casos de erro documentados: 400 VALIDATION_ERROR. A resposta de exemplo abaixo mostra a estrutura de uma resposta bem-sucedida em formato JSON.

Autenticação e segurança

Não é necessária autenticação

Idempotente: Não

Parâmetros

refreshToken(body, string, obrigatório)— Token de atualização emitido mais recentemente

Pedido de exemplo

{"refreshToken":"<Refresh-Token de /login>"}

Resposta de exemplo

{"ok":true,"token":"<novo JWT>","refreshToken":"<novo Refresh-Token>"}

Códigos de erro

400 VALIDATION_ERROR — O token de atualização está em falta, é inválido, expirou ou já foi usado.

Comportamento verificado

Um token de atualização válido devolve um novo par de tokens; um token inválido devolve 400 `VALIDATION_ERROR`.

Autenticação

Artigos relacionados

← Autenticação