Consultar eventos de un conductor

🔒

Sistema de seguridad externo requerido

Este endpoint está diseñado para ingestar información de otros sistemas de seguridad. En caso de no contar con un sistema externo, recomendamos no utilizar esta sección.

[ GET ]

Consulta los eventos de seguridad registrados para un conductor específico o para todos los conductores de la compañía en un día determinado o en un rango de fechas. Esta funcionalidad permite realizar análisis histórico detallado del comportamiento de conducción, generar reportes de seguridad vial, identificar patrones de riesgo, evaluar el desempeño de los conductores a lo largo del tiempo, y obtener métricas clave para la gestión de flotas. Es especialmente útil para supervisores y administradores que necesitan monitorear la seguridad de su flota, implementar programas de mejora continua, y cumplir con regulaciones de seguridad vial.

# Consulta para un día específico
https://sync.airbagtech.io/provider-data?driverId={{DRIVER_ID}}&date={{DATE}}

# Consulta para un rango de fechas
https://sync.airbagtech.io/provider-data?driverId={{DRIVER_ID}}&startDate={{START_DATE}}&endDate={{END_DATE}}

# Consulta con paginación
https://sync.airbagtech.io/provider-data?driverId={{DRIVER_ID}}&startDate={{START_DATE}}&endDate={{END_DATE}}&limit=100&page=2

Campos

Nombre	Tipo	Requerido	Descripción
driverId	String	Opcional	ID del conductor del cual se desea consultar la información. Este campo debe ir como query parameter.
date	String	Opcional	Fecha específica del registro en formato ISO 8601 (YYYY-MM-DD). Ejemplo: "2025-10-19".
startDate	String	Opcional	Fecha inicial del rango en formato ISO 8601 (YYYY-MM-DD). Debe usarse junto con endDate.
endDate	String	Opcional	Fecha final del rango en formato ISO 8601 (YYYY-MM-DD). Debe usarse junto con startDate.
limit	Number	Opcional	Límite de registros a devolver por página. Por defecto 50, máximo 1000.
page	Number	Opcional	Número de página actual para la paginación. Por defecto 1.

Headers

Autorization
apikey {{API_KEY}}

Ejemplos

Consulta para un día específico

curl --location 'https://sync.airbagtech.io/provider-data?driverId=1234&date=2023-10-01' \
--header 'Authorization: apikey {{API_KEY}}'

Consulta para un rango de fechas

curl --location 'https://sync.airbagtech.io/provider-data?driverId=1234&startDate=2023-10-01&endDate=2023-10-03' \
--header 'Authorization: apikey {{API_KEY}}'

Consulta con paginación

curl --location 'https://sync.airbagtech.io/provider-data?startDate=2023-10-01&endDate=2023-10-31&limit=100&page=2' \
--header 'Authorization: apikey {{API_KEY}}'


## Respuesta exitosa

```json
{
  "status": true,
  "data": [
    {
      "driverId": "1234",
      "distance": 150.5,
      "score": 85.2,
      "date": "2023-10-01",
      "securityEvents": [
        {
          "event": "speeding",
          "count": 2
        }
      ]
    },
    {
      "driverId": "5678",
      "distance": 200.0,
      "score": 92.5,
      "date": "2023-10-01",
      "securityEvents": [
        {
          "event": "braking",
          "count": 1
        },
        {
          "event": "acceleration",
          "count": 3
        }
      ]
    }
  ],
  "pagination": {
    "total": 32,
    "totalPages": 16,
    "currentPage": 1,
    "hasNext": true,
    "remainingItems": 30
  }
}

ℹ️

Tipos de eventos

Los valores del campo event dentro de securityEvents corresponden a las llaves listadas en la documentación de Eventos.

Respuesta sin datos

{
  "status": true,
  "data": [],
  "pagination": {
    "total": 0,
    "totalPages": 0,
    "currentPage": 1,
    "hasNext": false,
    "remainingItems": 0
  }
}

Respuesta con error

{
	"status": false,
	"error": "You are not authorized to perform this action",
	"errorId": "-1"
}

Notas importantes

• Todos los parámetros son opcionales, permitiendo consultas flexibles.
• Si no se especifica driverId, se devolverán datos de todos los conductores de la compañía.
• Si se usa startDate, debe incluirse también endDate, y viceversa.
• La paginación está incluida en todas las respuestas exitosas.
• El límite por defecto es 50 registros, con un máximo de 1000 por página.
• La respuesta siempre devuelve un array en data, incluso para consultas de un solo día.