Ir al contenido

Solicitar restablecimiento de contraseña

POST
/auth/forgot-password
curl --request POST \
--url https://api.dev.lade.com.mx/auth/forgot-password \
--header 'Content-Type: application/json' \
--data '{ "email": "usuario@ejemplo.com" }'

Inicia el flujo forgot-password de Cognito (ForgotPassword), que envía un código de verificación por correo. Por seguridad, siempre responde el mismo mensaje genérico exista o no la cuenta, salvo si se excede el límite de intentos o la cuenta no está confirmada.

Media typeapplication/json
object
email
required
string format: email
Example
{
"email": "usuario@ejemplo.com"
}

Mensaje genérico de confirmación (no revela si el email existe)

Media typeapplication/json
object
message
string
Example
{
"message": "Si el correo está registrado, recibirás un código en tu bandeja de entrada."
}

Solicitud inválida

Media typeapplication/json
object
error
required
string
message
string
field
string
Example
{
"error": "Validation failed",
"field": "email",
"message": "Invalid email format"
}

Demasiadas solicitudes en poco tiempo (rate limit de Cognito)

Media typeapplication/json
object
error
required
string
message
string
field
string
Example
{
"error": "Demasiados intentos. Espera unos minutos.",
"code": "LIMIT_EXCEEDED"
}