Solicitar Redefinição de Senha
Inicia o fluxo de redefinição de senha para um usuário da organização.
O chamador se autentica via assinatura RSA (middleware OriginValidation),
não por token de usuário — pois o usuário que solicita o reset não está
logado. O header user-agent identifica o sistema chamador (ex: admin,
storemanager) e é verificado criptograficamente contra a chave pública
correspondente em etc/keys/{user-agent}.pem.
O user-agent verificado é gravado como a origin do request. Somente
a mesma origin pode confirmar o reset posteriormente — esse é o
origin lock, que impede que um token emitido por um sistema seja
utilizado por outro.
Anti-enumeração: Quando o login não existe, o endpoint retorna
{ "requested": true } sem token ou personId. O chamador não
consegue distinguir isso de um request bem-sucedido e deve sempre exibir
uma mensagem genérica ("verifique seu e-mail") para o usuário final.
Cooldown: Um intervalo mínimo de 5 minutos é aplicado por
(organization, login). Um segundo request dentro desse período
retorna HTTP 429.
O chamador é responsável por entregar o token ao usuário (e-mail, WhatsApp, etc.) — o Connect gera e valida o token, mas não envia nenhuma notificação.
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 (e.g. admin) and the
signature header with the RSA-signed nonce. No x-guper-authorization
token is required — the user is not authenticated.
Cabeçalhos
Corpo da requisição
Content-Type:
application/json