Eventos

Los eventos son un resumen diario por conductor: cuántos eventos de seguridad tuvo cada día, cuánta distancia recorrió, cuánto tiempo condujo y, si existe, su puntaje de seguridad. Airbag usa esta información para la gamificación y el seguimiento de cada conductor.

🔒

Disponible únicamente para eventos de fuentes externas

Estos endpoints operan únicamente con eventos provenientes de una integración de telemetría externa (Samsara, Motive) o con eventos enviados a Airbag mediante API.

No incluyen los eventos generados por el tracking propio de Airbag. Esos eventos se consultan por viaje en Logs de viaje y resumidos por día en Resumen diario de viajes.

Datos incluidos

Cada registro corresponde a un conductor en un día e incluye:

• driverId y date (YYYY-MM-DD) que identifican el registro.
• distance (kilómetros) y duration (horas) recorridas ese día.
• score: puntaje de seguridad del sistema externo, o null si no se envió.
• securityEvents: lista de eventos {event, count} del día; puede venir vacía si el conductor no tuvo eventos.

Flujo de ingesta y consulta

El siguiente diagrama resume cómo los datos de telemetría llegan a Airbag y cómo tu sistema los consulta más tarde.

Autenticación

Todos los endpoints de eventos se consumen mediante Authorization: apikey {API_KEY}. Solicita tu API key con el equipo de soporte y mantenla en un almacén seguro; evita compartirla por canales no cifrados.

Buenas prácticas

• Envía un registro por conductor y por día, aunque no haya tenido eventos (securityEvents: []): así se distingue un día sin eventos de un día sin información.
• Si corriges un día ya enviado, reenvía el registro completo: el nuevo reemplaza al anterior.
• Agrupa hasta 50 registros por llamada para reducir el número de peticiones.

Tipos de eventos soportados

Estos son los eventos de seguridad que acepta Crear o actualizar información del día. Usa el buscador o explora por categoría para encontrar la llave que necesitas. Cualquier otro valor se rechaza con un error 400.

29 tipos de evento

Velocidad y señales

Eventos relacionados con la velocidad y el respeto a las señales de tránsito.

• speedingExceso de velocidad
• ran_red_lightSemáforo ignorado
• did_not_yieldNo cedió paso
• rolling_stopAlto incompleto

Maniobras bruscas

Fuerzas detectadas por el acelerómetro en maniobras agresivas.

• accelerationAceleración brusca
• brakingFrenado brusco
• corneringCurva brusca
• yaw_controlCorrección de curva

Distracción

Pérdida de atención del conductor al volante.

• phone_distractionDistracción por teléfono
• mobile_usageUso del celular
• distractionConducción distraída
• drowsySomnolencia
• late_responseReacción tardía
• eating_drinkingComiendo/bebiendo
• smokingFumando

Proximidad y colisión

Distancia de seguimiento y riesgo de impacto con otros vehículos.

• near_collisionCasi choque
• crashChoque
• forward_collision_warningAlerta de choque
• tailgatingConducción pegada
• following_distanceDistancia de seguimiento

Carril

Desviaciones respecto al carril.

• lane_departureInvasión de carril

Seguridad del vehículo

Condiciones del vehículo y del equipo de seguridad.

• no_seatbeltSin cinturón de seguridad
• obstructed_cameraCámara obstruida
• rollover_protectionRiesgo de volcadura

Estilo de manejo

Patrones de conducción, deseables o de riesgo.

• aggressive_drivingConducción agresiva
• unsafe_maneuverManiobra insegura
• unsafe_parkingEstacionamiento inseguro
• defensive_drivingConducción defensiva

General

Indicador global del día.

• overallEvaluación general

nota

En empresas integradas con Samsara o Motive, la consulta también puede devolver fuel_efficiency e idling_percentage. Airbag carga esos valores; no se pueden enviar con el POST.