POST/api/auth/reset-password
Define uma nova palavra-passe com o token de reposição do e-mail de reposição.
Envie `token` (da hiperligação do e-mail de reposição) e a nova `password` no corpo JSON. Não é necessário iniciar sessão para isso. A palavra-passe tem de cumprir os requisitos mínimos da Zentor App. Em caso de sucesso, o servidor responde com `{"ok":true}`; depois, o utilizador inicia sessão com a nova palavra-passe. Um token inválido, expirado ou já usado, bem como uma palavra-passe que não cumpra os requisitos mínimos, resultam em 400 `VALIDATION_ERROR`. Um token é consumido após uma utilização bem-sucedida; para outra alteração, inicie um novo processo através de `POST /api/auth/forgot-password`. O endpoint está limitado a 10 pedidos por 15 minutos por endereço IP. Transmita o token e a palavra-passe apenas no corpo do pedido via HTTPS, nunca como parâmetro de URL.
Visão geral
Chamada: POST /api/auth/reset-password. 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: token (body), password (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
token(body, string, obrigatório)— Token de reposição do e-mailpassword(body, string, obrigatório)— Nova palavra-passePedido de exemplo
{"token":"<Token do e-mail de reset>","password":"NovaPalavraPasseSegura!"}Resposta de exemplo
{"ok":true}Códigos de erro
400 VALIDATION_ERROR — O token é inválido, expirou ou já foi usado, ou a palavra-passe não cumpre os requisitos mínimos.Comportamento verificado
Um token inválido devolve 400 `VALIDATION_ERROR`. O caso de sucesso (200 `{"ok":true}`) é descrito com base no fluxo documentado.
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/refreshTroca um token de atualização válido por um novo par de token de acesso e token de atualização.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/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.