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 recentementePedido 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
POST /api/auth/loginAutentica um utilizador com endereço de e-mail ou nome de utilizador e palavra-passe, e emite um token de acesso (JWT) e um token de atualização (refresh token).POST /api/auth/forgot-passwordInicia a reposição de uma palavra-passe: se existir uma conta com o e-mail indicado, esta recebe um e-mail com uma hiperligação para a reposição.POST /api/auth/reset-passwordDefine uma nova palavra-passe com o token de reposição do e-mail de reposição.POST /api/auth/sso/exchangeÚltimo passo de um início de sessão SSO (SAML/OIDC): troca o código de utilização única do redirecionamento por um token de acesso e um token de atualização.