POST/api/auth/forgot-password

Inicia el restablecimiento de una contraseña: si existe una cuenta con la dirección de correo indicada, recibe un correo con un enlace para restablecerla.

Envíe la dirección de correo de la cuenta en el campo `email`. La respuesta `{"ok":true}` es deliberadamente siempre la misma, independientemente de si existe una cuenta, para que este endpoint no permita averiguar qué direcciones están registradas. La nueva contraseña se establece después con el token del correo mediante `POST /api/auth/reset-password`. Si falta el campo `email` o está vacío, el endpoint responde con 400 `VALIDATION_ERROR`. Para evitar abusos, el número de solicitudes por dirección IP está limitado (429 `RATE_LIMIT_EXCEEDED`).

Descripción general

Llamada: POST /api/auth/forgot-password. Este endpoint pertenece al grupo «Autenticación» de la API de Zentor App. Es de acceso público y no requiere autenticación. La llamada es idempotente: las llamadas repetidas con los mismos datos devuelven el mismo resultado. Parámetros obligatorios: email (body). Casos de error documentados: 400 VALIDATION_ERROR. La respuesta de ejemplo siguiente muestra la estructura de una respuesta correcta en formato JSON.

Autenticación y seguridad

No se requiere autenticación

Idempotente: Sí

Parámetros

email(body, string, obligatorio)— Dirección de correo de la cuenta

Solicitud de ejemplo

{"email":"user@example.com"}

Respuesta de ejemplo

{"ok":true}

Códigos de error

400 VALIDATION_ERROR — El campo `email` falta o está vacío.

Comportamiento verificado

La respuesta es 200 `{"ok":true}`, independientemente de si la cuenta existe; un campo de correo ausente devuelve 400 `VALIDATION_ERROR`.

Autenticación

Artículos relacionados

← Autenticación