Entrar

Validar Token de Redefinição de Senha

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

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:

  1. Existência — o hash SHA-256 do token bruto deve corresponder a um registro em password_reset_request.
  2. Organização — o registro deve pertencer à organização atual.
  3. Status — tokens used e superseded são rejeitados com um motivo específico para que a UI possa exibir a mensagem apropriada.
  4. 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

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.

Corpo da requisição

Content-Type: application/json

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

Respostas

{
    "valid": true
}

Relacionados

Copied to clipboard