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 correo
password(body, string, obligatorio)— Nueva contraseña

Solicitud 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

Artículos relacionados

← Autenticación