Entrar

Validar Token de Restablecimiento de Contraseña

POST https://{organization}.myguper.com/api/connect/password-reset/validate

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:

  1. Existencia — el hash SHA-256 del token bruto debe coincidir con un registro en password_reset_request.
  2. Organización — el registro debe pertenecer a la organización actual.
  3. Estado — tokens used y superseded son rechazados con un motivo específico para que la UI pueda mostrar el mensaje apropiado.
  4. 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

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Cuerpo de la petición

Content-Type: application/json

{
    "token": "a1b2c3d4e5f6...64 hex characters"
}

Respuestas

{
    "valid": true
}

Relacionados

Copied to clipboard