RÉFÉRENCE API · TÉLÉMÉTRIE VÉHICULE

Une API. Toutes les marques.

État en direct, recharge, trajets, scores UBI et analytique de flotte — par une API compatible Smartcar, avec des webhooks signés HMAC. Sans boîtiers ni applis mobiles.

Points de terminaison

Authentification par clé API dans l'en-tête Authorization. Toutes les réponses sont en JSON. Les paramètres de chemin notés {vin} désignent le VIN du véhicule.

GET
/api/v1/vehicles

Véhicules connectés à votre appli. Format de liste compatible Smartcar.

GET
/api/v1/vehicles/{vin}

État complet en direct — batterie, recharge, position, compteur kilométrique, attributs.

GET
/api/v1/vehicles/{vin}/battery

État de charge (%) et autonomie estimée (km).

GET
/api/v1/vehicles/{vin}/charge

État de recharge, statut de branchement, puissance (kW), énergie de session.

GET
/api/v1/vehicles/{vin}/location

Coordonnées GPS (exige la permission read_location).

GET
/api/v1/vehicles/{vin}/odometer

Lecture du compteur kilométrique en km.

GET
/api/v1/vehicles/{vin}/attributes

VIN, marque, modèle, année, enseigne.

GET
/api/v1/charging-sessions?limit=50

Historique de recharge à travers les véhicules connectés, plus récent d'abord.

GET
/api/v1/vehicles/{vin}/behavior?days=30

Sommaire de comportement de conduite : distance, temps de conduite, vitesse max/moyenne, comptes d'accélérations et de freinages brusques. Échantillons natifs du véhicule à cadence de 30 s en éveil.

GET
/api/v1/vehicles/{vin}/scores?days=7

Scores UBI — Sécurité (freinage 30 % + accélération 30 % + vitesse 40 %) et Éco (0–100), série quotidienne plus agrégat pondéré par la distance. Non noté sous 1 km/jour.

GET
/api/v1/vehicles/{vin}/trips?days=30

Trajets segmentés : début/fin, durée, distance par delta d'odomètre, vitesse max/moyenne, compte d'échantillons. Le champ confidence marque la provenance (vehicle_native).

GET
/api/v1/vehicles/{vin}/incidents?days=90

Événements proxy d'accident : pointes de décélération brusque (≥25 km/h/s) avec gravité, vitesses avant/après et GPS optionnel. Signal proxy — à corroborer avant toute décision de sinistre.

GET
/api/v1/fleet/points?days=30

DriveCoins gagnés à travers votre flotte connectée : totaux + répartition par véhicule. Pondérés par la distance, liés à la sécurité, confisqués sous un score de 50.

GET
/api/v1/fleet/leaderboard?days=30

Véhicules de flotte classés par score de sécurité pondéré par la distance, avec DriveCoins et badges de rang. Conçu pour les classements de programmes UBI.

TeslaFordHyundaiKiaVolkswagenAudiRivianPorschePolestarToyotaBMWNissanMercedesVolvo