Eventos API.

Lea los viajes puntuados, las rutas GPS y los desgloses a nivel de factor AURA por encima de HTTP. La telemetría se captura en el borde mediante los conectores SDK y certificados; la API le da a su stack el resultado puntuado y explicable. AURA respalda la suscripción: la aseguradora autorizada conserva la autoridad para fijar precios.

Obtenga acceso a la zona de pruebas Ver el SDK

Inicio rápido

Autentíquese y luego lea una puntuación.

Cada solicitud lleva un token de portador y un alcance de flota opcional. Las respuestas son JSON con un indicador ok de nivel superior.

Autenticación

Pase un token de portador en el encabezado de Autorización. Alcance una solicitud para una flota con el encabezado x-fleet-id opcional; omítelo y los tokens de administrador verán cada flota que poseen.

cURL · authenticated request

curl https://api.yas.dev/v1/trips \
  -H "Authorization: Bearer $YAS_TOKEN" \
  -H "x-fleet-id: fleet_joie"

# Base URL
# Sandbox  https://api.sandbox.yas.dev/v1
# Productionhttps://api.yas.dev/v1

200 OK · application/json

{
  "ok": true,
  "trips": [
    { "tripId": "trip_2026_0142", "overallScore": 72.4, "tier": "Good" }
  ],
  "pagination": { "page": 1, "limit": 20, "totalPages": 9, "total": 172 }
}

Referencia

Score finales principales.

Score finales de solo lectura para viajes, rutas, puntuaciones y vehículos. La ingestión se produce a través de SDK y conectores, no a través de un punto final de escritura pública.

GET/v1/tripsBearer
List scored trips, newest first, with pagination and fleet scope.
GET/v1/trips/{id}Bearer
Retrieve a single trip with its summary metrics and GPS link.
GET/v1/trips/{id}/score-breakdownBearer
Theme-by-factor AURA score breakdown for one trip.
GET/v1/vehicles/{plate}Bearer
Vehicle risk profile and driver roster.

Ejemplo

Recuperar un desglose de la puntuación del viaje.

El desglose agrupa aproximadamente 100 factores de riesgo en seis temas, cada uno con su propia subpuntuación, y nombra el tema más débil para que sepas dónde orientar el comportamiento.

GET /v1/trips/{id}/score-breakdown

{
  "ok": true,
  "breakdown": {
    "tripId": "trip_2026_0142",
    "overallScore": 72.4,
    "mapMatched": true,
    "themes": [
      {
        "id": "speeding", "label": "Speeding",
        "themeScore": 68.2,
        "factors": [
          { "key": "speedingIntensity", "score": 71.5 }
        ]
      }
    ],
    "weakestTheme": { "id": "speeding", "label": "Speeding" }
  }
}

modelo de datos

El objeto Viaje.

Un viaje es la unidad de puntuación. Estos son los campos que leen la mayoría de las integraciones; el esquema completo se encuentra en los documentos de referencia.

campo	Tipo	Descripción
`tripId`	`string`	Stable identifier for the trip.
`overallScore`	`number`	AURA score for the trip, 0–100. Higher is safer.
`tier`	`string`	Derived band: Critical (<45), Fair (<65), Good (<80), Safe.
`mapMatched`	`boolean`	Whether the trip was map-matched to the road network.
`distanceKm`	`number`	Trip distance in kilometres.
`durationMin`	`number`	Trip duration in minutes.
`startDate`	`string`	ISO 8601 start timestamp.
`vehicle`	`string`	Vehicle plate or unit identifier.

Convenciones

Predecible por diseño.

Errores

Los errores devuelven ok: false con una cadena de error y un estado HTTP convencional: 400, 401, 403, 404, 429 o 500.

Paginación

Los puntos finales de lista toman la página y el límite (10–100) y devuelven un bloque de paginación con página, límite, totalPages y total.

Alcance de la flota

Los alcances del encabezado x-fleet-id leen a una flota. Un alcance que no coincide devuelve 404, nunca datos de otra flota.

Niveles de puntuación

Los niveles se derivan de una escala: Crítico, Regular, Bueno, Seguro: las mismas bandas en todos los tipos de máquinas.

seguir construyendo

Dónde ir a continuación.

SDK

Capture el movimiento y GPS en el borde en iOS y Android.

SDK

Integraciones

Conecte plataformas telemáticas y feeds OEM.

Integraciones

Construya contra una caja de arena.

Los pilotos calificados obtienen credenciales de sandbox y documentos de referencia. Cuéntanos tu superficie de integración y mercados.

Obtenga acceso a la zona de pruebas