API-Dokumentation

Integriere ABRPs leistungsfähiges EV-Routing und die Planungsfunktionen in deine Plattform. Unsere API-Suite verbindet fahrzeugbewusstes Routing, Telemetrie und Deep Linking nahtlos.

APIs und Integration

Nutze unsere APIs, um EV-Routing, Telemetrie und Deep Links in deine Plattform einzubinden.

Planning API

v2 – empfohlen

v1 – Legacy

Fahrzeugbewusstes Routing mit umfassenden EV-Planungsfunktionen

Die Planning API liefert anspruchsvolle Routenplanung, die mit den kontinuierlichen Verbesserungen von ABRP mitwächst. Dazu zählen Verbrauchsmodelle, Ladeoptimierung, Echtzeit-Verkehr und wetterbewusste Planung.

Die API folgt einer REST-Architektur mit JSON-Ausgabe und unterstützt sowohl Legacy- (v1) als auch aktuelle (v2) Endpunkte. Einrichtungskosten und nutzungsbasierte Preise richten sich nach deinem Integrationsumfang und Volumen.

Dokumentation Planning API v2 Dokumentation Planning API v1 (Legacy)

Telemetry API

Echtzeit-Fahrzeugdaten für Live-Tracking und Fahrzeugmodellierung

Mit der Telemetry API überträgst du Fahrzeugdaten in Echtzeit – für Live-Reiseverfolgung, Verbrauchsanalyse und die fortlaufende Verbesserung unserer Modelle. So schärfen wir Energieprognosen und Routing-Genauigkeit.

Kostenlose API-Schlüssel stehen zur Integration bereit. Für das Senden von Daten sind Nutzer-Tokens erforderlich – am besten über unseren OAuth2-Flow, alternativ manuell für Tests und Entwicklung.

Dokumentation Telemetrie Deine Telemetrie-API-Schlüssel verwalten

OAuth2-API

Sichere Nutzerauthentifizierung und -autorisierung

OAuth2 ermöglicht eine sichere und komfortable Identifikation und Anmeldung bei Iternio. Für die Einrichtung brauchst du einen API-Schlüssel sowie eine Redirect-URL und den Anwendungsnamen.

Autorisierungsablauf

Der erste Aufruf liefert eine HTML-Seite, auf der sich Nutzer anmelden und deine Anwendung freigeben. Im Standardbrowser kann eine bestehende Anmeldung den Ablauf vereinfachen.

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

Erlaubte Scopes:

get_telemetry: Neueste Telemetrie des Nutzers abrufen
set_telemetry: Neue Telemetrie-Updates an das Fahrzeug senden
get_plan: Letzten Plan in gekürzter Form abrufen (Details auf Anfrage)
vehicle_history: Vergangene Fahrten und Ladevorgänge abrufen (Details auf Anfrage)

Antwort an deiner Redirect-URI:

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

Token abrufen

Nach Erhalt des Autorisierungscodes holst du das Token ab; es kann gespeichert und bei Bedarf wiederverwendet werden.

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

Antwortformat:

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

Nutzerinformationen

Nach dem Token nutzt du den Endpunkt „me“, um Nutzerdaten abzurufen:

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

Antwortformat:

{
  "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>"
}

Deep Links

URL-basierte Integration für vorkonfigurierte Routenplanung

Erstelle eigene URLs, die ABRP mit voreingestellten Routen, Fahrzeugwahl und Planparametern starten – ideal zum Einbetten in Apps, Websites oder Navigationssysteme ohne API-Anbindung.

Deep Links unterstützen zahlreiche Parameter: Start-/Zielkoordinaten, Wegpunkte, Fahrzeugmodelle, Ladestand und Nutzereinstellungen. Basis-URL: https://abetterrouteplanner.com

Dokumentation Deep Links