Activar conductor (reenviar credenciales)
POST/drivers/activate/:id
Propósito
Reactiva un conductor generando una nueva contraseña y reenviando el email con las credenciales de acceso.
Objetivo
Permitir que un conductor que ha perdido sus credenciales o cuya cuenta necesita reactivación reciba un nuevo email con contraseña generada automáticamente.
Casos de uso
- Un conductor olvidó sus credenciales y el gestor las regenera.
- Se necesita reactivar el acceso de un conductor tras un periodo de inactividad.
- El email de bienvenida original no llegó al conductor.
Flujo de activación
flowchart TD
A[Recibir POST /drivers/activate/:id] --> B{¿Conductor existe?}
B -->|No| C[404 NOT_FOUND]
B -->|Sí| D{¿Pertenece a la empresa?}
D -->|No| E[403 NOT_ALLOWED]
D -->|Sí| F[Generar nueva contraseña aleatoria]
F --> G[Hashear y guardar contraseña]
G --> H[Enviar email con nuevas credenciales]
H --> I[200 OK - Datos del conductor]
Detalles técnicos
- Verifica que el conductor exista y pertenezca a
cia.truckers. - Genera una contraseña aleatoria con
tools.generatePass(). - La contraseña se hashea y se actualiza en el usuario.
- Se envía un email
createNewTruckercon las nuevas credenciales (misma plantilla que la creación). - Devuelve los datos parseados del conductor tras la activación.
- No modifica el estado
statusdel conductor; solo regenera la contraseña.
Autenticación
Requiere JWT Bearer token o API Key.
Request
Responses
- 200
- 401
- 403
- 404
- 500
Conductor activado con nueva contraseña. Se envía email con credenciales
Response Headers
Token JWT o API Key ausente, expirado o inválido
Response Headers
El conductor no pertenece al array truckers de la empresa autenticada
Response Headers
No se encontró un conductor con el ID proporcionado
Response Headers
Error inesperado al activar el conductor