Eventos

Los eventos recopilan hitos relevantes detectados por los dispositivos y usuarios: alertas, incidencias de seguridad y acciones operativas que requieren seguimiento. Cada evento conserva contexto temporal y geográfico para facilitar análisis posteriores.

Datos incluidos

• Identificador único y categoría del evento.
• Ubicación aproximada y marca de tiempo del suceso.
• Descripción, adjuntos y estado de resolución.

Flujo de ingesta y consulta

El siguiente diagrama resume cómo los datos de telemetría llegan a Airbag y cómo la aplicación móvil del conductor 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

• Clasifica los eventos con descripciones claras para priorizar la respuesta.
• Mantén consistencia en los estados (abierto, en seguimiento, resuelto) para facilitar reportes.
• Documenta cualquier acción tomada sobre el evento dentro de la nota de resolución.

Tipos de eventos soportados

Actualmente contamos con los siguientes tipos de eventos de seguridad. Usa el buscador o explora por categoría para encontrar la llave que necesitas.

27 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.

• mobile_usageDistracción por teléfono
• generic_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_collisonCasi choque
• crashChoque
• forward_collision_warningAlerta de choque
• generic_tailgatingConducción pegada
• following_distanceDistancia de seguimiento
• following_distance_moderateDistancia de seguimiento media
• following_distance_severeDistancia de seguimiento alta

Carril

Desviaciones respecto al carril.

• lane_departureInvasión carril
• edge_distracted_drivingInvasión carril lateral

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 volcadura

Conducción positiva

Comportamientos deseables del conductor.

• defensive_drivingConducción defensiva