Entrar

Solicitar Redefinição de Senha

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

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

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

{
    "login": "maria.silva@company.com"
}

Respostas

{
    "requested": true,
    "token":     "a1b2c3d4e5f6...64 hex characters",
    "personId":  4399137,
    "login":     "maria.silva@company.com"
}

Relacionados

Copied to clipboard