Crear nueva notificación (Solo Admin)
POST/notifications
Crea una nueva notificación en el sistema. Solo usuarios administradores pueden usar este endpoint. La mayoría de notificaciones se crean automáticamente por el sistema cuando ocurren eventos.
Validaciones:
- Debe especificarse
company_userOtrucker_cia, pero no ambos - El tipo debe ser uno de los tipos válidos definidos en el sistema
- Título máximo 255 caracteres, mensaje máximo 1000 caracteres
- Fechas programadas deben ser futuras
- Rate limiting: máximo 10 notificaciones por minuto por usuario
Campos obligatorios:
type: Tipo de notificacióntitle: Título descriptivomessage: Mensaje detalladocompany_userOtrucker_cia: Destinatario
Campos opcionales:
priority: Nivel de prioridad (default: medium)data: Datos adicionales específicos del tiporelatedEntityTypeyrelatedEntityId: Entidad relacionadascheduledFor: Programar envío para fecha futuraexpiresAt: Fecha de expiración automática
Ejemplo de uso:
- Notificaciones administrativas o de mantenimiento
- Comunicaciones específicas a usuarios o empresas
- Mensajes programados para envío futuro
Request
Responses
- 200
- 400
- 401
- 403
- 429
Notificación creada exitosamente
Solicitud inválida
No autorizado
Error de autorización, validación o permisos insuficientes
Demasiadas solicitudes - rate limit excedido