API de gestion de flotte pour Vethy VS02 PRO: REST + GraphQL pour les intégrations personnalisées

• Table des matières

1. API REST: paramètres pour la télémétrie, la configuration, l'OTA, le diagnostic
2. API GraphQL : requêtes efficaces pour les tableaux de bord
3. Authentification OAuth 2,0 et contrôle d'accès basé sur les rôles
4. Evénements Webhook : poussée en temps réel pour les alertes de défaut et achèvement de l'OTA

De nombreux grands exploitants de parcs avec plus de 500 camions construisent des plates-formes de gestion de parcs propriétaires en interne plutôt que de se fier uniquement à Geotab, Samsara ou Webfleet. Pour ces flottes, Vethy fournit un accès direct à l'API REST et GraphQL à tous les diagnostics Vethy VS02 PRO et V-FMSG-24, à la configuration, à la gestion OTA et BMS. Cette page documente les endpoints de l'API, le flux d'authentification OAuth 2,0, les abonnements à des événements webhook, les limites de tarifs et les modèles d'intégration communs utilisés par les équipes informatiques de la flotte chez Schneider National, J.B. Hunt, Mærsk, DSV, DB Schenker et Kuehne+Nagel.

API REST: paramètres pour la télémétrie, la configuration, l'OTA, le diagnostic

URL de base : https://api.vethy.com/v2/. Endpoints principaux : **GET /fleet/{fleet_id}/véhicules** — liste de tous les véhicules équipés de VS02 PRO. **GET /vehicules/{vin}/télémétrie?de=&à=&fields=** — télémétrie historique (temps de conduite, SoC, température, énergie). **GET /vewies/{vin}/telemétrie/vie** — état actuel. **GET /véhicules/{vine}/diagnostics** — codes de défaut et santé du BMS. **POST /vehicules /{vin}/config** — point de commande, AC habilitable/désactivable, calendrier OTA. **GET /veiches/{vin}/ota/status** — version firmware et historique de mise à jour. Toutes les réponses JSON avec la pagination, ISO 8601 timestamps, et les en-têtes de vitesse-limite (X-RateLimit-Remaining).

API GraphQL : requêtes efficaces pour les tableaux de bord

Endpoint de GraphQL : https://api.vethy.com/graphql. Une seule requête peut obtenir un résumé AC à l'échelle de la flotte, un état en direct par véhicule, des défauts BMS récents et des mises à jour OTA en attente d'un aller-retour. Exemple de requête : question FleetDashboard { flotte(id: "abc") { vehicleCount, totalAcRuntimeHours, avgLithiumSoc, vehicles(filter: { failCount_gt: 0 }) { vin, driverName, lithiumSoc, fails { code, sévérité, depuis } } } . Les abonnements GraphQL prennent en charge les mises à jour en temps réel sur WebSocket — utilisé par Schneider National pour les tableaux de bord des opérations en direct.

Authentification OAuth 2,0 et contrôle d'accès basé sur les rôles

Vethy API utilise le flux de code d'autorisation OAuth 2,0 pour l'accès au contexte utilisateur et le flux de lettres de client pour le serveur au serveur. Rôles : visionneur de flotte (télémétrie de lecture), gestionnaire de flotte (lecture + écrit config), gestionnaire de flotte (texte + configuration + gestion OTA), auditeur de sécurité (lecture uniquement des journaux d'audit). Les jetons expirent 1 heure avec la rotation des jetons de rafraîchissement. Tous les appels de l'API enregistrés pour la conformité de vérification SOC 2 de type II. Vethy publie la collection OpenAPI 3,1 spec et Postman.

Evénements Webhook : poussée en temps réel pour les alertes de défaut et achèvement de l'OTA

Configurer l'URL webhook via POST /fleet/{fleet_id}/webhooks. Evénements : ac.fault.critic, ac.fault.avertissement, ac.fault,resolu, ota.update.programmed, ota.updata.installing, ota.up date.success, ota.up Date.failed, lithium.soc.low, lithium.hability.degraded. Charge utile signée avec HMAC-SHA256 en utilisant le secret partagé. Webhook réessaye avec un retour exponentiel (5 tentatives sur 24 heures). Utilisé par Mærsk pour l'intégration en temps réel dans le NOC central (centre d'opérations du réseau).

Foire aux questions

L'accès API est-il inclus avec VS02 PRO ou coût supplémentaire?

L'accès à l'API est inclus dans l'abonnement Vethy Fleet+ (€8/camion/mois). Les achats autonomes VS02 PRO sans Fleet+ ont un accès limité à l'API (télémétrie de 30 jours, aucun abonnement webhook). L'intégration Geotab/Samsara/Webfleet via la passerelle FMS n'a pas de coût supplémentaire pour l'API Vethy.

Quelles sont les limites de taux applicables à l'API ?

Par défaut : 100 requêtes/min par client OAuth et 10 000 requêtes/jour. Les abonnés Fleet+ peuvent demander un relèvement des limites jusqu’à 1,000/min et 1 000,000/jour. Les requêtes GraphQL dont la complexité dépasse 1000 sont limitées séparément. La livraison des webhooks est illimitée, mais plafonnée à 100 événements/seconde par URL de webhook.

Vethy publie-t-il des SDK dans Python, Node.js, Java ou .NET ?

Oui — SDKs officiels chez github.com/vethy/vethy-sdk dans Python (vethy-sdK-python), Node.js (vethy-s dk-js), Java (vethy-sddk-java) et .NET (Vethy.SDK). Des SDK communautaires sont disponibles pour Go, Ruby et Rust. Tous les SDKs manipulent automatiquement la mise à jour d'OAuth, la vérification de la signature de la limite de vitesse et la vérification de la signature webhook.

Comment le temps de disponibilité de l'API est-il garanti ?

Vethy API SLA : 99,95 % de disponibilité mensuelle pour les abonnés de Fleet+, 99,9 % pour les abonnés autonomes. Déploiement multirégions à travers l'AWS eu-west-1 (Irlande), us-est-1 (Virginie), ap-sud-est-1 (Singapour). Page d'état à status.vethy.com avec les temps d'arrêt et les incidents post-mortem.