Autenticación de la API

Airbag Sync protege cada endpoint mediante API keys únicas. Estas llaves se asignan a organizaciones autorizadas y permiten rastrear cualquier integración.

Cómo obtener la API key

1. Contacta a un agente de soporte de Airbag Tech mediante tu canal empresarial habitual.
2. Proporciona la información de tu proyecto y los correos responsables de custodiar la llave.
3. Recibe la API key de forma segura y guárdala en tu gestor de secretos o variables de entorno.

Uso en las solicitudes

Incluye siempre el encabezado Authorization: apikey {API_KEY} en cada llamada. El esquema apikey va en minúsculas y separado de la llave por un espacio. Para operaciones con cuerpo JSON, agrega también Content-Type: application/json. El encabezado Accept es opcional.

curl --location 'https://sync.airbagtech.io/driver/?size=1' \
  --header 'Authorization: apikey ${API_KEY}'

Errores de autenticación

Estas respuestas pueden llegar desde cualquier endpoint, antes de que se procese la solicitud. A diferencia del resto de los errores de la API, el detalle viene en el campo error (no en message).

Código	Cuándo	Respuesta
400	Falta el encabezado Authorization o no empieza con apikey (por ejemplo Bearer o ApiKey).	{"status": false, "error": "Authorization header is not valid"}
401	La API key no existe o está inactiva.	{"status": false, "error": "You are not authorized to perform this action", "errorId": "-1"}
500	No se pudo validar la llave por un error interno.	{"status": false, "error": "Something went wrong", "errorId": "..."}

Identificadores de conductores, vehículos y administradores

Todo driverId, vehicleId o managerId que envías, ya sea en la ruta, en los parámetros de consulta o en el cuerpo, acepta el ID que tu empresa definió al crear el registro o el airbagId que devuelve la API.

• La API busca primero el valor como ID de tu empresa y, si no existe, como airbagId. Si un valor es a la vez el ID de tu empresa en un registro y el airbagId de otro, se usa el registro con ese ID de tu empresa.
• Sólo se buscan registros de tu propia compañía.
• Cuando una respuesta repite el ID, siempre devuelve el ID de tu empresa (o el airbagId si el registro no tiene uno), aunque la consulta se haya hecho con el airbagId. Es el caso de driverId en Consultar eventos, vehicleId en Cambiar estado de un conductor y userId en Consultar actividades.

Recomendaciones de seguridad

• Rota las API keys de forma periódica y elimina las que no utilices.
• No compartas la llave por canales no cifrados ni la incorpores en repositorios públicos.
• No existe un ambiente de pruebas: cada llamada opera sobre los datos reales de tu empresa. Prueba tus integraciones con pocos registros antes de enviar lotes completos y monitorea el uso a través de registros internos.