API-documentatie

Integreer de krachtige EV-routing en -planning van ABRP in je platform. Onze uitgebreide API-suite maakt naadloze integratie mogelijk van voertuigbewuste routing, telemetrie en deep linking.

API's & integratie

Krijg toegang tot onze API-suite om EV-routing, telemetrie en deep linking in je platform te integreren.

Planning API

v2 - Aanbevolen

v1 - Legacy

Voertuigbewuste routing met uitgebreide EV-planning

Onze Planning API levert geavanceerde routeplanning die meegroeit met de doorlopende verbeteringen van ABRP. Denk aan modellering van energieverbruik, laadoptimalisatie, realtime verkeer en planning met weersinvloed.

De API gebruikt een REST-architectuur met JSON-output en ondersteunt zowel legacy- (v1) als moderne (v2) endpoints. Setupkosten en prijs per plan verschillen op basis van je integratiebehoeften en gebruiksvolume.

v2 Planning-documentatie v1 Planning-documentatie (legacy)

Telemetry API

Realtime voertuigdata voor live tracking en modellering van auto’s

Met de Telemetry API stream je realtime voertuigdata voor live reistracking, verbruiksanalyse en voortdurende verbetering van onze voertuigmodellen. Zo verfijnen we energievoorspellingen en nauwkeurigheid van routing.

Er zijn gratis API-keys beschikbaar voor integratie. Voor het versturen van data heb je user tokens nodig; die krijg je via onze OAuth2-flow (aanbevolen) of handmatig voor testen en ontwikkeling.

Telemetry-documentatie Beheer je telemetry-API-keys

OAuth2 API

Veilige gebruikersauthenticatie en autorisatie

OAuth2 is een veilige en handige manier om gebruikers bij Iternio te identificeren en te authenticeren. Voor OAuth2 heb je een API-key nodig en moet je een redirect-URL en applicatienaam opgeven.

Autorisatieflow

De eerste aanroep geeft een HTML-pagina terug waar gebruikers kunnen inloggen en je applicatie goedkeuren. Als die in de standaardbrowser van de gebruiker opent, kan de login worden gecacht om het proces te versnellen.

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

Toegestane scopes:

get_telemetry: Laatste telemetrie van de gebruiker ophalen
set_telemetry: Nieuwe telemetrie-updates naar het voertuig sturen
get_plan: Laatste plan in compacte vorm ophalen (neem contact met ons op voor details)
vehicle_history: Historische ritten en laadsessies ophalen (neem contact met ons op voor details)

Antwoord op jouw redirect-URI:

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

Token ophalen

Zodra je een autorisatiecode hebt, haal je het token op; je kunt het opslaan en hergebruiken wanneer nodig.

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

Antwoordformaat:

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

Gebruikersinformatie

Na het verkrijgen van het token gebruik je het “me”-endpoint om gebruikersinformatie op te halen:

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

Antwoordformaat:

{
  "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-gebaseerde integratie voor vooraf ingestelde routeplanning

Maak eigen URL’s die ABRP openen met vooraf ingestelde routes, voertuigkeuzes en planningsparameters. Perfect om in te bedden in apps, websites of navigatiesystemen zonder API-integratie.

Deep links ondersteunen veel URL-parameters, waaronder start-/bestemmingscoördinaten, waypoints, automodellen, laadniveau en gebruikersvoorkeuren. Basis-URL: https://abetterrouteplanner.com

Deep Links-documentatie