Consultar viajes de un conductor en un periodo

[ POST ]

Visualiza los viajes ejecutados de un conductor en un periodo de tiempo.

https://sync.airbagtech.io/trips/{{DRIVER_ID}}

Campos

Nombre	Tipo	Requerido	Descripción
DRIVER_ID	String	Si	ID del conductor que desea consultar. Este valor deberá ir en la ruta.
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 -g 'https://sync.airbagtech.io/trips/{{DRIVER_ID}}' \
--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 viaje realizado por el conductor dentro del rango de fechas solicitado.

{
  "status": true,
  "count": 14,
  "data": [
    {
      "startDate": "2025-02-02T20:11:45.000Z",
      "endDate": "2025-02-02T20:39:08.000Z",
      "distance": 6.12,
      "duration": 27.383333333333333,
      "group": "Región Norte",
      "airbagId": "12ab34cd_56ef_4789_90ab_c1d2e3f4a5b6"
    },
    {
      "startDate": "2025-02-02T21:02:51.000Z",
      "endDate": "2025-02-02T21:18:12.000Z",
      "distance": 4.87,
      "duration": 15.35,
      "group": "Región Norte",
      "airbagId": "78fa90bc_1d2e_43f4_85a6_b7c8d9e0f102"
    },
    {
      "startDate": "2025-02-04T01:14:30.000Z",
      "endDate": "2025-02-04T01:28:54.000Z",
      "distance": 5.21,
      "duration": 14.4,
      "group": "Región Norte",
      "airbagId": "34cd56ef_789a_4bcd_ef01_234567890abc"
    },
    {
      "vehicleId": "Qr3StUv4WxYz5aBcDeFg",
      "startDate": "2025-02-05T17:22:09.000Z",
      "endDate": "2025-02-05T17:28:01.000Z",
      "distance": 3.94,
      "duration": 5.866666666666666,
      "group": "Región Norte",
      "airbagId": "5a6b7c8d_9e0f_4112_8334_556677889900"
    },
    {
      "vehicleId": "Qr3StUv4WxYz5aBcDeFg",
      "startDate": "2025-02-05T17:30:44.000Z",
      "endDate": "2025-02-05T17:54:12.000Z",
      "distance": 20.18,
      "duration": 23.466666666666665,
      "group": "Región Norte",
      "airbagId": "a1b2c3d4_e5f6_4708_9102_3456789abcde"
    },
    {
      "vehicleId": "Qr3StUv4WxYz5aBcDeFg",
      "startDate": "2025-02-07T16:40:11.000Z",
      "endDate": "2025-02-07T17:15:02.000Z",
      "distance": 54.3,
      "duration": 34.85,
      "group": "Región Norte",
      "airbagId": "bc8f9012_3456_4789_a0b1_c2d3e4f50607"
    },
    {
      "vehicleId": "Qr3StUv4WxYz5aBcDeFg",
      "startDate": "2025-02-10T18:05:36.000Z",
      "endDate": "2025-02-10T18:12:18.000Z",
      "distance": 2.87,
      "duration": 6.7,
      "group": "Región Norte",
      "airbagId": "90ab12cd_34ef_4567_89ab_cdef01234567"
    }
    // … (resto de viajes hasta completar los 14 elementos)
  ]
}

nota

En una respuesta real, data contiene count elementos. El ejemplo muestra solo algunos para ilustrar los dos escenarios: viajes sin vehicleId (cuando aún no se asocia un vehículo) y viajes con vehicleId una vez que el conductor tiene un vehículo asignado.

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 del conductor 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	Identificador del vehículo asociado al viaje. Puede no estar presente si el conductor aún no tenía un vehículo asignado al momento del viaje.
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.