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 cuentaSolicitud 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
POST /api/auth/loginInicia la sesión de un usuario con dirección de correo o nombre de usuario y contraseña, y emite un token de acceso (JWT) y un token de actualización (refresh token).POST /api/auth/refreshCambia un token de actualización válido por un nuevo par de token de acceso y token de actualización.POST /api/auth/reset-passwordEstablece una nueva contraseña con el token de restablecimiento del correo de restablecimiento.POST /api/auth/sso/exchangeÚltimo paso de un inicio de sesión SSO (SAML/OIDC): cambia el código de un solo uso de la redirección por un token de acceso y un token de actualización.