Validar Token de Restablecimiento de Contraseña
Valida un token de restablecimiento de contraseña sin consumirlo.
Esta es una verificación previa — el llamador la utiliza para decidir qué
mostrar al usuario antes de que escriba una nueva contraseña. El token
permanece pending y aún puede ser confirmado posteriormente.
El llamador se autentica mediante firma RSA (middleware OriginValidation), el mismo mecanismo usado en los pasos de solicitud y confirmación.
El endpoint verifica, en este orden:
- Existencia — el hash SHA-256 del token bruto debe coincidir con un
registro en
password_reset_request. - Organización — el registro debe pertenecer a la organización actual.
- Estado — tokens
usedysupersededson rechazados con un motivo específico para que la UI pueda mostrar el mensaje apropiado. - Expiración — tokens con más de 1 hora son rechazados como
expired.
Si todas las verificaciones pasan, la respuesta es { "valid": true }. De lo
contrario, { "valid": false, "reason": "..." } con uno de los códigos
a continuación.
Códigos de motivo:
| Código | Significado |
|--------|-------------|
| not_found | Token no existe o pertenece a otra organización |
| used | Token ya fue consumido por una llamada de confirmación |
| superseded | Se solicitó un reset más reciente para el mismo login |
| expired | Token tiene más de 1 hora |
Try-it values populated from environment ACME (Demo)
Autenticación
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.
Encabezados
Cuerpo de la petición
Content-Type:
application/json