Intégration
Vos outils parlent à nos traceurs.
Les positions et les alertes sont accessibles par API REST, par webhooks ou en export planifié. Trois intégrations, un même modèle de données.
Modes
Les trois modes d’intégration
| Critère | Mode | Latence | Usage | Inclus |
|---|---|---|---|---|
| API REST | Temps réel ou différé | Interroger les positions depuis votre outil métier | Plan Flotte | |
| Webhooks | Immédiat | Déclencher une action à chaque alerte ou sortie de zone | Plan Flotte | |
| Export CSV planifié | Journalier ou hebdomadaire | Traitement comptable, rapprochement de factures | Tous les plans |
Endpoints
Les ressources principales
| Ressource | Ce qu’elle retourne |
|---|---|
| GET /v1/vehicles | Liste des véhicules du compte, avec leur dernier état de connexion. |
| GET /v1/vehicles/{id}/positions | Historique des positions sur une plage de dates, paginé par curseur. |
| GET /v1/vehicles/{id}/trips | Trajets reconstitués : distance, durée, arrêts, vitesse moyenne. |
| GET /v1/alerts | Alertes générées, filtrables par type, véhicule et période. |
| GET /v1/geofences | Zones configurées, avec leurs horaires et leurs seuils. |
| POST /v1/webhooks | Enregistrement d’une URL de rappel pour un type d’événement. |
Cadre technique
Authentification et limites
- Authentification par jeton Bearer, renouvelé par un endpoint dédié, valable 24 heures.
- Limite de débit de 600 requêtes par minute et par compte, avec un en-tête de quota dans chaque réponse.
- Format JSON, encodage UTF-8, horodatage en ISO 8601 en UTC, coordonnées en degrés décimaux (WGS 84).
- Webhook signé par un en-tête HMAC-SHA256, avec reprise automatique en cas d’échec pendant 24 heures.
- Documentation complète remise à la signature, avec un environnement de test et un jeu de données d’exemple.
Exemple
Exemple de payload
{
"vehicle_id": "VH-204",
"timestamp": "2026-10-21T08:14:32Z",
"position": { "lat": 45.7642, "lon": 4.8357 },
"speed_kmh": 52,
"heading": 87,
"accuracy_m": 6,
"ignition": true,
"network": "orange-m2m"
}Un développeur, une intégration à écrire ?
Nous fournissons l’environnement de test, un jeu de données et un interlocuteur technique joignable pendant l’intégration. Le premier raccordement prend généralement une demi-journée.