Validar Token de Redefinição de Senha
Valida um token de redefinição de senha sem consumi-lo.
Esta é uma verificação prévia — o chamador a utiliza para decidir o que
exibir ao usuário antes que ele digite uma nova senha. O token permanece
pending e ainda pode ser confirmado posteriormente.
O chamador se autentica via assinatura RSA (middleware OriginValidation), o mesmo mecanismo usado nas etapas de solicitação e confirmação.
O endpoint verifica, nesta ordem:
- Existência — o hash SHA-256 do token bruto deve corresponder a um
registro em
password_reset_request. - Organização — o registro deve pertencer à organização atual.
- Status — tokens
usedesupersededsão rejeitados com um motivo específico para que a UI possa exibir a mensagem apropriada. - Expiração — tokens com mais de 1 hora são rejeitados como
expired.
Se todas as verificações passarem, a resposta é { "valid": true }. Caso
contrário, { "valid": false, "reason": "..." } com um dos códigos abaixo.
Códigos de motivo:
| Código | Significado |
|--------|-------------|
| not_found | Token não existe ou pertence a outra organização |
| used | Token já foi consumido por uma chamada de confirmação |
| superseded | Um reset mais recente foi solicitado para o mesmo login |
| expired | Token tem mais de 1 hora |
Try-it values populated from environment ACME (Demo)
Autenticação
Signature
RSA signature via OriginValidation middleware. Send the user-agent
header with the calling system's name and the signature header
with the RSA-signed nonce.
Cabeçalhos
Corpo da requisição
Content-Type:
application/json