Entrar

Solicitar Restablecimiento de Contraseña

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

Inicia el flujo de restablecimiento de contraseña para un usuario de la organización.

El llamador se autentica mediante firma RSA (middleware OriginValidation), no con un token de usuario — ya que el usuario que solicita el reset no ha iniciado sesión. El header user-agent identifica al sistema llamador (ej: admin, storemanager) y se verifica criptográficamente contra la llave pública correspondiente en etc/keys/{user-agent}.pem.

El user-agent verificado se almacena como el origin de la solicitud. Solo el mismo origin puede confirmar el reset posteriormente — este es el origin lock, que impide que un token emitido por un sistema sea utilizado por otro.

Anti-enumeración: Cuando el login no existe, el endpoint retorna { "requested": true } sin token ni personId. El llamador no puede distinguir esto de una solicitud exitosa y siempre debe mostrar un mensaje genérico ("revise su correo") al usuario final.

Cooldown: Se aplica un intervalo mínimo de 5 minutos por (organization, login). Una segunda solicitud dentro de ese período retorna HTTP 429.

El llamador es responsable de entregar el token al usuario (correo electrónico, WhatsApp, etc.) — Connect genera y valida el token, pero no envía ninguna notificación.

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 (e.g. admin) and the signature header with the RSA-signed nonce. No x-guper-authorization token is required — the user is not authenticated.

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

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

Respuestas

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

Relacionados

Copied to clipboard