Solicitar restablecimiento de contraseña

POST 
/forgot-password

Público (sin autenticación). Encola el envío al email indicado de un correo con un enlace a la aplicación web de MATICERTS (/#/auth/password-reset/{token}?email=...); el segmento {token} de ese enlace es el que se envía a POST /reset-password (válido 60 minutos). Cada solicitud aceptada invalida el token anterior, por lo que los enlaces de correos previos dejan de funcionar. Solo se permite una solicitud por usuario cada 60 segundos; antes de ese plazo se responde 422 con errors.email.

Request

Responses

200

Solicitud aceptada; el correo de restablecimiento queda en cola de envío.

422

email ausente o con formato inválido, o envío rechazado. En el segundo caso el error viene en errors.email: No se ha encontrado un usuario con esa dirección de correo. (email no registrado) o Por favor espere antes de volver a intentarlo. (menos de 60 s desde la solicitud anterior).

429

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. Es distinto de la espera de 60 s entre solicitudes para un mismo usuario, que responde 422.

500

Error interno no controlado (p. ej. fallo de base de datos al registrar el token). Cuerpo genérico {"message": "Server Error"}, sin success (o una página HTML si no se envía Accept: application/json). Un fallo del servidor de correo no produce 500: el envío se procesa en cola y la respuesta sigue siendo 200.