Consultar la información detallada de la actividad

[ GET ]

Consulta la información completa de una actividad, incluyendo las fotos y notas de voz adjuntas codificadas en Base64.

https://sync.airbagtech.io/activities/{{ACTIVITY_ID}}

Campos

Nombre	Tipo	Requerido	Descripción
ACTIVITY_ID	String	Sí	ID de la actividad a consultar: es el campo id de cada elemento que devuelve Consultar actividades. Debe enviarse en la ruta.
driverId	String	Sí	ID del conductor dueño de la actividad. Acepta el ID que tu empresa usó al crearlo o el airbagId. Se envía como parámetro de consulta (query param).

Headers

Authorization
apikey {{API_KEY}}

Ejemplo

curl -G 'https://sync.airbagtech.io/activities/{{ACTIVITY_ID}}' \
  --header 'Authorization: apikey {{API_KEY}}' \
  --data 'driverId=EMP-1042'

Respuestas

✅ Respuesta exitosa (200 OK)

Devuelve la ficha completa de la actividad, incluyendo los adjuntos codificados en Base64. Los arreglos photosBase64 y voicenotesBase64 estarán vacíos si la actividad no incluye esos recursos.

{
  "status": true,
  "activity": {
    "slug": "manual_deactivation",
    "message": "",
    "created": "2025-02-19T20:20:53.000Z",
    "position": {
      "lat": 19.41777,
      "lon": -99.17151
    },
    "location": "Ciudad de México",
    "photosBase64": [],
    "voicenotesBase64": []
  }
}

nota

• Los adjuntos se devuelven como cadenas Base64 sin el prefijo data:; para mostrarlos en un navegador, anteponlo manualmente (por ejemplo, data:image/jpeg;base64,<string> para imágenes o data:audio/mpeg;base64,<string> para notas de voz).
• El tamaño de la respuesta puede crecer considerablemente cuando la actividad incluye fotos o notas de voz. Evita consultar este endpoint en bucle si sólo necesitas la metadata.

Descripción de campos de respuesta

Campo	Tipo	Descripción
status	Boolean	Indica si la operación fue exitosa.
activity	Object	Objeto con los datos completos de la actividad. Ver tabla abajo.

Campos dentro de activity

Campo	Tipo	Descripción
slug	String	Identificador del tipo de actividad (por ejemplo manual_deactivation, entrega, gas). Consulta la lista completa de tipos en Actividades › Tipos de actividad.
message	String	Comentario escrito por el conductor al registrar la actividad. Puede estar vacío (""). En entregas y cargas de combustible se antepone un resumen generado por Airbag (por ejemplo Exitosa. o No exitosa. en una entrega).
created	String	Fecha y hora de creación de la actividad en formato ISO 8601 (UTC).
position	Object	Coordenadas del punto donde se registró la actividad.
position.lat	Number	Latitud en grados decimales.
position.lon	Number	Longitud en grados decimales.
location	String	Estado o provincia donde se registró la actividad. Es una cadena vacía ("") cuando no se pudo resolver.
photosBase64	Array<String>	Arreglo con las fotos adjuntas, codificadas en Base64. Estará vacío ([]) si la actividad no incluye fotografías.
voicenotesBase64	Array<String>	Arreglo con las notas de voz adjuntas, codificadas en Base64. Estará vacío ([]) si la actividad no incluye audios.

❌ Respuesta con error (400 Bad Request)

Se devuelve cuando la actividad no existe para ese conductor o cuando el driverId no corresponde a ningún conductor de tu empresa.

{
  "status": false,
  "message": "Activity not found",
  "errorId": "sentry_error_id_123"
}

Mensaje	Causa
Activity not found	No existe una actividad con ese ACTIVITY_ID para el conductor indicado.
Error: Driver not found	El driverId no corresponde a ningún conductor de tu empresa.

❌ Falta el conductor (404 Not Found)

Se devuelve cuando no se envía driverId.

{
  "status": false,
  "message": "driverId | activiyId not found"
}