Actividades
Las actividades representan acciones operativas registradas por los conductores o administradores: incluyen la persona responsable, el grupo asignado, fecha y hora, ubicación, velocidad, adjuntos y descripciones detalladas. Documentarlas correctamente permite trazar cada evento y generar reportes confiables.
¿Qué registra una actividad?
- Identidad del conductor o usuaria asociada.
- Grupo u operación donde ocurrió el evento.
- Fecha y hora exactas, país y georreferenciación (latitud y longitud).
- Velocidad estimada al momento del registro.
- Indicadores de evidencia (fotografía o nota de voz) y una descripción clara del suceso.
Tipos de actividad
Cada actividad tiene un tipo. Al crearla con Crear actividad se envía como slug, con uno de estos valores:
slug | Descripción | Campos adicionales |
|---|---|---|
entrega | Entrega de producto o servicio al destinatario. | wasDeliverySuccess (obligatorio) |
gas | Carga de combustible. | gasCost, gasLiters, gasType, gasMileageKm (obligatorios) |
stop | Parada durante la operación. | stopType (opcional) |
break | Descanso dentro de la jornada. | — |
traffic | Reporte de tráfico. | — |
load-handle | Carga de mercancía. | handleArriving (opcional) |
start_workday | Inicio de la jornada laboral. | — |
end_workday | Fin de la jornada laboral. | — |
other | Cualquier actividad no contemplada en las anteriores. Usa message para dar contexto. | otherType (opcional) |
Al consultarlas con Consultar actividades, el tipo se publica en el campo type con su nombre en español; la tabla de equivalencias está en esa página. Ese listado también puede incluir tipos que registra la app de Airbag (por ejemplo Mantenimiento o Accidente vial), aunque no se puedan crear desde esta API.
Autenticación
Las consultas y altas de actividades requieren una API key. Solicita la clave a un agente de soporte de Airbag Tech; solo se otorga a contactos autorizados y debe enviarse en el encabezado Authorization: apikey {API_KEY}.
Buenas prácticas
- Incluye siempre coordenadas precisas para auditorías posteriores.
- Agrega descripciones descriptivas que permitan comprender el contexto sin depender únicamente de adjuntos.
- Establece formatos internos para los nombres de actividad y evita abreviaturas ambiguas.