Saltar al contenido principal

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

NombreTipoRequeridoDescripción
ACTIVITY_IDStringID de la actividad a consultar. Puedes obtener los IDs al listar las actividades.

Debe enviarse en la ruta.
driverIdStringID del conductor dueño de la actividad. Se envía como parámetro de consulta (query param).

Headers

Autorization
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": "N/A",
"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

CampoTipoDescripción
statusBooleanIndica si la operación fue exitosa.
activityObjectObjeto con los datos completos de la actividad. Ver tabla abajo.

Campos dentro de activity

CampoTipoDescripción
slugStringIdentificador del tipo de actividad (por ejemplo manual_deactivation, entrega, gas). Consulta la lista completa de tipos en Actividades › Tipos de actividad.
messageStringComentario libre escrito por el conductor al registrar la actividad. Puede estar vacío ("").
createdStringFecha y hora de creación de la actividad en formato ISO 8601 (UTC).
positionObjectCoordenadas del punto donde se registró la actividad.
position.latNumberLatitud en grados decimales.
position.lonNumberLongitud en grados decimales.
locationStringDirección o descripción legible de la ubicación. Puede ser "N/A" cuando no se pudo resolver.
photosBase64Array<String>Arreglo con las fotos adjuntas, codificadas en Base64. Estará vacío ([]) si la actividad no incluye fotografías.
voicenotesBase64Array<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 el ACTIVITY_ID no existe o el driverId no coincide con el conductor dueño de la actividad.

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