Solicitud de recuperación de contraseña
POST/auth/recovery
Endpoint para solicitar la recuperación de contraseña de usuarios de empresa. Realiza las siguientes operaciones:
- Valida el formato del email
- Busca el usuario en la base de datos
- Genera un token de recuperación único
- Envía email con enlace para restablecer contraseña
Flujo detallado:
- Cliente envía email en formato JSON
- Servidor valida formato de email (400 si inválido)
- Busca usuario por email (404 si no existe)
- Genera token aleatorio de 32 caracteres
- Almacena token en base de datos asociado al usuario
- Envía email con enlace que contiene el token
- El enlace redirige a formulario para nueva contraseña
Seguridad:
- Los tokens tienen validez limitada (24h por defecto)
- Cada token es de un solo uso
- Requiere HTTPS
Ejemplo de petición:
{
"email": "usuario@empresa.com"
}
Ejemplo de respuesta exitosa:
{
"op": "recovery",
"message": "RECOVERY_EMAIL_SENT",
"email": "usuario@empresa.com"
}
Códigos de error:
- 400: Email no proporcionado o formato inválido
- 404: Usuario no encontrado
- 500: Error interno del servidor
Request
Responses
- 200
- 404
Email de recuperación enviado
Not found