Documentation API

Intègre à ta plateforme les puissantes capacités de routage et de planification VE d’ABRP. Notre suite d’API permet une intégration fluide du routage adapté au véhicule, de la télémétrie et des deep links.

API & Intégration

Accède à notre suite d’API pour intégrer le routage VE, la télémétrie et les liens profonds à ta plateforme.

API Planning

v2 - Recommandée

v1 - Legacy

Routage adapté au véhicule avec planification VE complète

Notre API Planning offre une planification d’itinéraires sophistiquée qui évolue avec ABRP. Modèles de consommation d’énergie, optimisation des recharges, intégration du trafic en temps réel et planification météo-aware.

L’API utilise une architecture REST avec sortie JSON et prend en charge les endpoints v1 (legacy) et v2. Les coûts d’installation et tarifs par plan dépendent de tes besoins et volumes.

Documentation Planning v2 Documentation Planning v1 (Legacy)

API Telemetry

Données véhicule en direct pour le suivi et la modélisation

L’API Telemetry permet la transmission en direct des données véhicule pour le suivi des trajets, l’analyse de consommation et l’amélioration de nos modèles. Cela affine les prédictions énergétiques et la précision du routage.

Des clés d’API gratuites sont disponibles. Des jetons utilisateur sont nécessaires et peuvent être obtenus via OAuth2 (recommandé) ou manuellement pour les tests.

Documentation Telemetry Gérer mes clés API Telemetry

API OAuth2

Authentification et autorisation sécurisées des utilisateurs

OAuth2 fournit une méthode sûre pour authentifier les utilisateurs avec Iternio. Pour le configurer, il te faut une clé API ainsi qu’une URL de redirection et un nom d’application.

Flux d’autorisation

Le premier appel renvoie une page HTML où l’utilisateur se connecte et approuve ton application. Dans son navigateur par défaut, le login peut être mis en cache.

https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>

Scopes autorisés :

get_telemetry: Récupérer la dernière télémétrie de l’utilisateur
set_telemetry: Envoyer une nouvelle télémétrie vers le véhicule
get_plan: Obtenir le dernier plan condensé (nous contacter pour plus de détails)
vehicle_history: Récupérer l’historique des trajets et recharges (nous contacter pour plus de détails)

Réponse à ton URI de redirection :

https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>

Récupération du jeton

Une fois le code d’autorisation reçu, récupère le jeton, qui peut être stocké et réutilisé.

https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>

Format de la réponse :

{
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}

Informations utilisateur

Avec le jeton, utilise l’endpoint « me » pour récupérer les informations utilisateur :

https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>

Format de la réponse :

{
  "user_id": <the numeric ID of the user>,
  "full_name": "<Full name of the user>",
  "email": "<Email of user>",
  "vehicle_id": <The numeric ID of the vehicle, if part of the scope>,
  "vehicle_name": "<The vehicle name>",
  "vehicle_typecode": "<The vehicle typecode>"
}

Liens profonds

Intégration via URL pour la planification préconfigurée

Crée des URL personnalisées qui lancent ABRP avec des itinéraires, véhicules et paramètres préconfigurés. Idéal pour des apps, sites ou systèmes de navigation sans intégration API.

Les liens profonds prennent en charge de nombreux paramètres : coordonnées de départ/arrivée, étapes, modèles, état de charge, préférences. URL de base : https://abetterrouteplanner.com

Documentation des liens profonds