Développeurs · Événements API
REST · JSON sur HTTP
Événements API.
Lisez les trajets notés, les itinéraires GPS et les répartitions au niveau du facteur AURA sur HTTP. La télémétrie est captée en bordure par les connecteurs SDK et certifiés ; l'API donne à votre stack le résultat marqué et explicable. AURA prend en charge la souscription – l'assureur agréé conserve le pouvoir de tarification.
Démarrage rapide
Authentifiez-vous, puis lisez une score.
Chaque demande comporte un jeton de porteur et une portée de flotte facultative. Les réponses sont JSON avec un indicateur ok de niveau supérieur.
Authentification
Passez un jeton de porteur dans l’en-tête Autorisation. Étendez une demande à une flotte avec l’en-tête facultatif x-fleet-id ; omettez-le et les jetons d'administrateur voient chaque flotte qu'ils possèdent.
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{
"ok": true,
"trips": [
{ "tripId": "trip_2026_0142", "overallScore": 72.4, "tier": "Good" }
],
"pagination": { "page": 1, "limit": 20, "totalPages": 9, "total": 172 }
}Référence
Points de terminaison principaux.
Points de terminaison en lecture seule pour les trajets, les itinéraires, les scores et les véhicules. L'ingestion se produit via le SDK et les connecteurs, et non via un point de terminaison d'écriture public.
- GET
/v1/tripsList scored trips, newest first, with pagination and fleet scope.
- GET
/v1/trips/{id}Retrieve a single trip with its summary metrics and GPS link.
- GET
/v1/trips/{id}/score-breakdownTheme-by-factor AURA score breakdown for one trip.
- GET
/v1/vehicles/{plate}Vehicle risk profile and driver roster.
Exemple
Récupérez une réscore des scores de voyage.
La réscore regroupe environ 100 facteurs de risque en six thèmes, chacun avec son propre sous-score, et nomme le thème le plus faible afin que vous sachiez où coacher.
{
"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" }
}
}Modèle de données
L'objet Voyage.
Un voyage est l’unité de notation. Ce sont les champs que la plupart des intégrations lisent — le schéma complet se trouve dans la documentation de référence.
| Champ | Tapez | Descriptif |
|---|---|---|
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. |
Congrès
Prévisible par conception.
Erreurs
Les échecs renvoient ok : false avec une chaîne d'erreur et un statut conventionnel HTTP – 400, 401, 403, 404, 429 ou 500.
Pagination
Les points de terminaison de liste prennent page et limite (10 à 100) et renvoient un bloc de pagination avec page, limite, totalPages et total.
Portée de la flotte
Les étendues d’en-tête x-fleet-id se lisent sur une seule flotte. Un champ d'application incompatible renvoie 404 – jamais les données d'une autre flotte.
Niveaux de score
Les niveaux sont dérivés d'une échelle : Critique, Passable, Bon, Sûr – les mêmes bandes pour chaque type de machine.
Continuez à construire
Où aller ensuite.
Construisez contre un bac à sable.
Les pilotes qualifiés obtiennent des informations d'identification sandbox et des documents de référence. Faites-nous part de votre surface d'intégration et de vos marchés.