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. Acepta el ID que tu empresa usó al crearlo o el airbagId. Este valor deberá ir en la ruta.
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 -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"
    }
  ]
}

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 | 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 el DRIVER_ID no corresponde a ningún conductor de tu empresa, o 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: Driver 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.