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	Inicio del periodo (inclusive). Se devuelven los viajes que terminaron a partir de este instante. ISO 8601
endDate	String	Si	Fin del periodo (exclusivo): se devuelven los viajes que terminaron antes de este instante. Debe ser posterior a startDate. Una fecha sin hora (2025-01-31) equivale a las 00:00, así que deja fuera ese día; para incluirlo envía el día siguiente. ISO 8601

Headers

Content-Type	Authorization
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"
    }
  ]
}

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	ID del vehículo definido por tu empresa (o su airbagId si no tiene uno). Es null o no aparece cuando el viaje no tiene vehículo asignado.
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.

⚠️ No se pudo completar la consulta (404 Not Found)

Se devuelve cuando alguno de los viajes del periodo tiene un vehículo o un grupo que ya no existe (en ese caso no se devuelve ningún viaje). status es true.

{
  "status": true,
  "message": "Error: Vehicle not found"
}

❌ Parámetros inválidos (400 Bad Request)

{
  "status": false,
  "message": "Error: startDate must be before endDate",
  "errorId": "sentry_error_id_123"
}

Mensaje	Causa
Error: StartDate && EndDate pair must be present.	Se envió sólo una de las dos fechas.
Error: startDate or endDate not valid	Alguna fecha no tiene un formato válido.
Error: startDate must be before endDate	startDate es igual o posterior a endDate, o no se envió ninguna fecha.