Consultar la info de las actividades

[ POST ]

Consulta las actividades registradas por uno o varios conductores dentro de un rango de fechas. El endpoint es de sólo lectura y no genera ningún cambio sobre los datos.

https://sync.airbagtech.io/activities/all

Campos

Nombre	Tipo	Requerido	Descripción
startDate	String	Sí	Fecha de inicio de la consulta (inclusive). Formato: YYYY-MM-DD.
endDate	String	Sí	Fecha de fin de la consulta (inclusive). Formato: YYYY-MM-DD.
driverId	String	No	ID del conductor a consultar. Omite este campo para obtener las actividades de todos los conductores del rango.

Headers

Content-Type	Autorization
application/json	apikey {{API_KEY}}

Body

{
  "startDate": "string",
  "endDate": "string",
  "driverId": "string"
}

Ejemplo

curl --location 'https://sync.airbagtech.io/activities/all' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: apikey {{API_KEY}}' \
  --data '{
    "startDate": "2025-01-01",
    "endDate": "2025-01-31",
    "driverId": "EMP-1042"
  }'

Respuestas

✅ Respuesta exitosa (200 OK)

Devuelve un arreglo con las actividades registradas dentro del rango de fechas solicitado. Cada entrada incluye la metadata del conductor, la ubicación donde se registró la actividad y los adjuntos disponibles (foto y nota de voz).

{
  "status": true,
  "data": [
    {
      "driver": "Juan Pérez Ramírez",
      "userId": "EMP-1042",
      "group": "Región Norte",
      "hour": "09:17",
      "date": "12-February-2025",
      "type": "entrega",
      "state": "Nuevo León",
      "country": "México",
      "lat": 25.67123,
      "lon": -100.31842,
      "speed": "",
      "photo": "Si",
      "voice_note": "No",
      "description": "Entrega completada al cliente"
    },
    {
      "driver": "Juan Pérez Ramírez",
      "userId": "EMP-1042",
      "group": "Región Norte",
      "hour": "11:42",
      "date": "12-February-2025",
      "type": "gas",
      "state": "Nuevo León",
      "country": "México",
      "lat": 25.68045,
      "lon": -100.32517,
      "speed": "28",
      "photo": "Si",
      "voice_note": "Si",
      "description": "Carga de 45 L en estación de servicio"
    },
    {
      "driver": "María López Torres",
      "userId": "EMP-1087",
      "group": "Región Centro",
      "hour": "15:08",
      "date": "14-February-2025",
      "type": "alerta",
      "state": "Jalisco",
      "country": "México",
      "lat": 20.67353,
      "lon": -103.34402,
      "speed": "",
      "photo": "No",
      "voice_note": "Si",
      "description": "Cliente ausente; se reprograma visita"
    }
  ]
}

nota

En una respuesta real, data puede contener tantas actividades como se hayan registrado dentro del rango solicitado. Si no hay coincidencias, data es un arreglo vacío ([]).

Descripción de campos de respuesta

Campo	Tipo	Descripción
status	Boolean	Indica si la operación fue exitosa.
data	Array<Object>	Lista de actividades que coinciden con los filtros. Ver tabla abajo.

Campos dentro de cada elemento de data

Campo	Tipo	Descripción
userId	String	ID del conductor que registró la actividad (el mismo que utilizas en tus sistemas).
driver	String	Nombre completo del conductor al momento del registro.
group	String	Nombre del grupo al que pertenecía el conductor. Puede ser una cadena vacía ("") si no tenía grupo asignado.
type	String	Tipo de actividad reportada. Consulta la lista completa de valores soportados en Actividades › Tipos de actividad.
date	String	Fecha del registro en formato DD-MonthName-YYYY (el mes se escribe en inglés y con mayúscula inicial).
hour	String	Hora del registro en formato HH:mm (24 h, zona horaria local del conductor).
country	String	País donde se registró la actividad.
state	String	Estado/provincia donde se registró la actividad.
lat	Number	Latitud del punto donde se registró la actividad (grados decimales).
lon	Number	Longitud del punto donde se registró la actividad (grados decimales).
speed	String	Velocidad del conductor en km/h al momento del registro. Es una cadena vacía ("") cuando el vehículo estaba detenido o no se pudo medir.
photo	String	"Si" si el conductor adjuntó una fotografía, "No" en caso contrario.
voice_note	String	"Si" si el conductor adjuntó una nota de voz, "No" en caso contrario.
description	String	Comentario libre escrito por el conductor al momento de registrar la actividad. Puede estar vacío.

❌ Respuesta con error (400 Bad Request)

Se devuelve cuando faltan campos obligatorios, las fechas tienen un formato inválido o el driverId proporcionado no existe.

{
  "status": false,
  "message": "Error: Invalid date format, expected YYYY-MM-DD",
  "errorId": "sentry_error_id_123"
}