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-mail
password(body, string, obrigatório)— Nova palavra-passe

Pedido 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

Artigos relacionados

← Autenticação