POST/api/auth/reset-password
Establece una nueva contraseña con el token de restablecimiento del correo de restablecimiento.
Envíe `token` (del enlace del correo de restablecimiento) y la nueva `password` en el cuerpo JSON. No es necesario iniciar sesión para ello. La contraseña debe cumplir los requisitos mínimos de Zentor App. Si tiene éxito, el servidor responde con `{"ok":true}`; después, el usuario inicia sesión con la nueva contraseña. Un token inválido, caducado o ya usado, así como una contraseña que no cumple los requisitos mínimos, dan como resultado 400 `VALIDATION_ERROR`. Un token se consume tras un uso exitoso; para otro cambio, inicie un nuevo proceso mediante `POST /api/auth/forgot-password`. El endpoint está limitado a 10 solicitudes cada 15 minutos por dirección IP. Transmita el token y la contraseña solo en el cuerpo de la solicitud a través de HTTPS, nunca como parámetro de URL.
Descripción general
Llamada: POST /api/auth/reset-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 no es idempotente: cada llamada correcta vuelve a desencadenar la acción. Parámetros obligatorios: token (body), password (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: No
Parámetros
token(body, string, obligatorio)— Token de restablecimiento del correopassword(body, string, obligatorio)— Nueva contraseñaSolicitud de ejemplo
{"token":"<Token del correo de reset>","password":"NuevaContraseñaSegura!"}Respuesta de ejemplo
{"ok":true}Códigos de error
400 VALIDATION_ERROR — El token es inválido, ha caducado o ya se ha usado, o la contraseña no cumple los requisitos mínimos.Comportamiento verificado
Un token inválido devuelve 400 `VALIDATION_ERROR`. El caso de éxito (200 `{"ok":true}`) se describe según el flujo documentado.
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/forgot-passwordInicia 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.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.