Consultar viajes de la compañia en un periodo

[ POST ]

Visualiza los viajes ejecutados de toda tu empresa en un periodo de tiempo.

https://sync.airbagtech.io/trips/

Campos

Nombre	Tipo	Requerido	Descripción
startDate	String	Si	Fecha de inicio desde dónde se a consultar. ISO 8601
endDate	String	Si	Fecha final desde dónde se a consultar. ISO 8601

Headers

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

Body

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

Ejemplo

curl --location 'https://sync.airbagtech.io/trips/' \
--header 'Content-Type: application/json' \
--header 'Authorization: apikey {{API_KEY}}' \
--data '{
    "startDate": "string",
    "endDate": "string"
}'

Respuestas

✅ Respuesta exitosa (200 OK)

Devuelve el número total de viajes encontrados y un arreglo con la información resumida de cada uno de ellos dentro del rango de fechas solicitado.

{
  "status": true,
  "count": 42,
  "data": [
    {
      "vehicleId": "a1b2c3d4_e5f6_47a8_9b0c_1d2e3f4a5b6c",
      "startDate": "2025-02-03T14:12:05.000Z",
      "endDate": "2025-02-03T14:38:47.000Z",
      "distance": 8.42,
      "duration": 26.7,
      "group": "Norte",
      "airbagId": "f7e8d9c0_b1a2_43c4_d5e6_f7a8b9c0d1e2"
    },
    {
      "vehicleId": null,
      "startDate": "2025-02-04T09:05:18.000Z",
      "endDate": "2025-02-04T09:22:44.000Z",
      "distance": 5.91,
      "duration": 17.433333333333334,
      "group": "",
      "airbagId": "3b4c5d6e_7f80_4192_a3b4_c5d6e7f80192"
    },
    {
      "vehicleId": "Kp9qLmRsT2uVwXyZaBcD",
      "startDate": "2025-02-05T18:27:30.000Z",
      "endDate": "2025-02-05T19:11:06.000Z",
      "distance": 31.08,
      "duration": 43.6,
      "group": "Sucursal Centro",
      "airbagId": "9a0b1c2d_3e4f_4506_7a8b_9c0d1e2f3456"
    },
    {
      "vehicleId": "Np7QrSt8UvWxYz0AbCdE",
      "startDate": "2025-02-07T22:41:52.000Z",
      "endDate": "2025-02-07T23:19:04.000Z",
      "distance": 19.47,
      "duration": 37.2,
      "group": "Sur",
      "airbagId": "2c3d4e5f_6071_4283_94a5_b6c7d8e9f012"
    },
    {
      "vehicleId": null,
      "startDate": "2025-02-09T11:03:11.000Z",
      "endDate": "2025-02-09T11:05:49.000Z",
      "distance": 0.94,
      "duration": 2.633333333333333,
      "group": "Pruebas-Interno",
      "airbagId": "6e7f8091_a2b3_44c5_d6e7_f8091a2b3c4d"
    }
    // … (resto de viajes hasta completar los 42 elementos)
  ]
}

nota

En una respuesta real, data contiene count elementos. El ejemplo anterior muestra solo algunos para ilustrar los distintos escenarios (con vehicleId, sin vehicleId, con group definido y con group vacío).

Descripción de campos de respuesta

Campo	Tipo	Descripción
status	Boolean	Indica si la operación fue exitosa.
count	Number	Número total de viajes devueltos en data.
data	Array<Object>	Lista de viajes registrados dentro del periodo solicitado. Ver tabla abajo.

Campos dentro de cada elemento de data

Campo	Tipo	Descripción
airbagId	String	Identificador interno único del viaje en la plataforma Airbag.
vehicleId	String | null	Identificador del vehículo asociado al viaje. Es null cuando el viaje no fue asignado a ningún vehículo.
startDate	String	Fecha y hora de inicio del viaje en formato ISO 8601 (UTC).
endDate	String	Fecha y hora de finalización del viaje en formato ISO 8601 (UTC).
distance	Number	Distancia recorrida durante el viaje, expresada en kilómetros.
duration	Number	Duración del viaje expresada en minutos (valor decimal).
group	String	Nombre del grupo al que pertenece el conductor al momento del viaje. Puede ser una cadena vacía ("") si el conductor no tenía grupo asignado.