Ereignisse API.

Lesen Sie bewertete Fahrten, GPS Routen und Aufschlüsselungen auf Faktorebene AURA über HTTP. Die Telemetrie wird am Edge durch die SDK und zertifizierten Anschlüsse erfasst; Die API gibt Ihrem Stack das erzielte, erklärbare Ergebnis. AURA unterstützt das Underwriting – der lizenzierte Versicherer behält die Preishoheit.

Erhalten Sie Sandbox-Zugriff SDK ansehen

Schnellstart

Authentifizieren Sie sich und lesen Sie dann eine Score.

Jede Anfrage enthält ein Inhabertoken und einen optionalen Flottenbereich. Die Antworten sind JSON mit einem OK-Flag der obersten Ebene.

Authentifizierung

Übergeben Sie ein Bearer-Token im Authorization-Header. Begrenzen Sie eine Anfrage mit dem optionalen x-fleet-id-Header auf eine Flotte. Wenn Sie es weglassen, sehen Admin-Token jede Flotte, die sie besitzen.

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 }
}

Referenz

Kernendpunkte.

Schreibgeschützte Endpunkte für Fahrten, Routen, Punktestände und Fahrzeuge. Die Aufnahme erfolgt über SDK und Konnektoren, nicht über einen öffentlichen Schreibendpunkt.

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.

Beispiel

Rufen Sie eine Aufschlüsselung der Reisebewertung ab.

Die Aufschlüsselung gruppiert etwa 100 Risikofaktoren in sechs Themen, jedes mit seiner eigenen Unterbewertung, und nennt das schwächste Thema, damit Sie wissen, wo Sie trainieren sollten.

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" }
  }
}

Datenmodell

Das Trip-Objekt.

Eine Fahrt ist die Einheit der Wertung. Dies sind die Felder, die von den meisten Integrationen gelesen werden – das vollständige Schema finden Sie in den Referenzdokumenten.

Feld	Typ	Beschreibung
`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.

Konventionen

Vom Design her vorhersehbar.

Fehler

Fehler geben ok: false mit einer Fehlerzeichenfolge und einem herkömmlichen HTTP-Status zurück – 400, 401, 403, 404, 429 oder 500.

Paginierung

Listenendpunkte übernehmen „page“ und „limit“ (10–100) und geben einen Paginierungsblock mit „page“, „limit“, „totalPages“ und „total“ zurück.

Flottenumfang

Der x-fleet-id-Header umfasst Lesevorgänge für eine Flotte. Ein nicht übereinstimmender Bereich gibt 404 zurück – niemals die Daten einer anderen Flotte.

Punktestufen

Die Stufen werden von einer Skala abgeleitet: Kritisch, Mittelmäßig, Gut, Sicher – die gleichen Bänder für jeden Maschinentyp.

Bauen Sie weiter

Wohin als nächstes?

SDK

Erfassen Sie Bewegung und GPS am Rand auf iOS und Android.

SDK

Integrationen

Verbinden Sie Telematikplattformen und OEM-Feeds.

Integrationen

Bauen Sie gegen eine Sandbox.

Qualifizierte Piloten erhalten Sandbox-Anmeldeinformationen und Referenzdokumente. Teilen Sie uns Ihre Integrationsoberfläche und Märkte mit.

Erhalten Sie Sandbox-Zugriff