Restablecer contraseña
POST/reset-password
Público (sin autenticación). Restablece la contraseña usando el token recibido por correo tras POST /forgot-password. El token es de un solo uso y expira a los 60 minutos. Al restablecer se regenera el remember_token del usuario; los tokens Bearer ya emitidos no se revocan. Tras el restablecimiento se envía al usuario un correo de aviso de cambio de contraseña.
Request
Responses
- 200
- 422
- 429
- 500
Contraseña restablecida exitosamente
Validación fallida (campos ausentes, email inválido, contraseña de menos de 8 caracteres o sin confirmar) o restablecimiento rechazado. En el segundo caso el error viene en errors.email: Este token de restablecimiento de contraseña es inválido. (token inválido, usado o expirado) o No se ha encontrado un usuario con esa dirección de correo.
Límite general de 60 peticiones por minuto excedido (sin sesión, se cuenta por IP). La cabecera Retry-After indica los segundos de espera.
Error interno no controlado (p. ej. fallo de base de datos al guardar la nueva contraseña). Cuerpo genérico {"message": "Server Error"}, sin success (o una página HTML si no se envía Accept: application/json). Nota: el correo de aviso de cambio de contraseña se envía después de guardar la nueva contraseña; normalmente se procesa en cola, pero si el envío se hace de forma inmediata y falla, la respuesta puede ser 500 aunque la contraseña ya haya quedado cambiada.