API-dokumentation

Integrera ABRP:s kraftfulla EV-routing och planeringsfunktioner i din plattform. Vår omfattande API-svit gör det möjligt att integrera fordonsmedveten routing, telemetri och deep links sömlöst.

API:er och integration

Få tillgång till vår API-svit för att integrera EV-routing, telemetri och deep links i din plattform.

Planning API

v2 – rekommenderas

v1 – legacy

Fordonsmedveten routing med omfattande EV-planeringsfunktioner

Vårt Planning API levererar avancerad ruttplanering som utvecklas i takt med ABRP:s löpande förbättringar. Funktionerna omfattar modellering av energiförbrukning, optimering av laddning, integrering av realtidstrafik och väderbaserad planering.

API:et använder REST-arkitektur med JSON-svar och stöder både äldre (v1) och nyare (v2) endpoints. Uppstartskostnader och pris per plan varierar beroende på integrationsbehov och förbrukningsvolym.

v2 Planning-dokumentation v1 Planning-dokumentation (legacy)

Telemetry API

Realtidsdata från fordonet för live spårning och fordonsmodellering

Telemetry-API:et gör det möjligt att överföra fordonsdata i realtid för live reseövervakning, förbrukningsanalys och löpande förbättring av våra fordonsmodeller. Det hjälper oss att förfina energiprognoser och ruttprecision.

Gratis API-nycklar finns för integration. Användartokens krävs för att skicka data och kan erhållas antingen via vårt OAuth2-flöde (rekommenderas) eller via manuell tokenhämtning för testning och utveckling.

Telemetry-dokumentation Hantera dina Telemetry API-nycklar

OAuth2 API

Säker användarautentisering och behörighet

OAuth2 ger ett säkert och bekvämt sätt att identifiera och autentisera användare hos Iternio. För att sätta upp OAuth2 behöver du en API-nyckel och måste ange en redirect-URL och ett applikationsnamn.

Auktoriseringsflöde

Det första anropet returnerar en HTML-sida där användarna kan logga in och godkänna din applikation. Om sidan öppnas i användarens standardwebbläsare kan inloggningen vara cachad för att förenkla processen.

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

Tillåtna scopes:

get_telemetry: Hämta användarens senaste telemetri
set_telemetry: Skicka nya telemetriuppdateringar för fordonet
get_plan: Hämta senaste plan i förkortad form (kontakta oss för detaljer)
vehicle_history: Hämta historiska resor och laddningssessioner (kontakta oss för detaljer)

Svar till din redirect-URI:

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

Tokenhämtning

När du har fått en auktoriseringskod hämtar du token, som kan sparas och återanvändas vid behov.

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

Svarformat:

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

Användarinformation

När du har token använder du "me"-endpointen för att hämta användarinformation:

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

Svarformat:

{
  "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-baserad integration för förkonfigurerad ruttplanering

Skapa anpassade URL:er som startar ABRP med förkonfigurerade rutter, fordonsval och planeringsparametrar. Perfekt för att bädda in i appar, webbplatser eller navigationssystem utan API-integration.

Deep links stöder ett brett utbud av URL-parametrar, inklusive start- och slutkoordinater, vägpunkter, fordonsmodeller, laddningsnivåer och användarinställningar. Bas-URL: https://abetterrouteplanner.com

Deep links-dokumentation