API-dokumentation

Integrér ABRPs kræftfulde EV-routing- og planlægningsmuligheder i din platform. Vores omfattende API-suite gør det muligt at integrere køretøjsbevidst routing, telemetri og deep links problemfrit.

API’er og integration

Få adgang til vores API-suite for at integrere EV-routing, telemetri og deep links i din platform.

Planning API

v2 – anbefalet

v1 – legacy

Køretøjsbevidst routing med omfattende EV-planlægningsmuligheder

Vores Planning API leverer avanceret ruteplanlægning, der udvikler sig i takt med ABRPs løbende forbedringer. Funktionerne omfatter modellering af energiforbrug, optimering af opladning, integration af realtidstrafik og vejrbevidst planlægning.

API’en bruger REST-arkitektur med JSON-output og understøtter både ældre (v1) og nyere (v2) endepunkter. Omkostninger til opsætning og pris pr. plan varierer ud fra dine integrationsbehov og forbrugsvolumen.

v2 Planning-dokumentation v1 Planning-dokumentation (legacy)

Telemetry API

Realtids køretøjsdata til live sporing og bilmodellering

Telemetry API’en gør det muligt at overføre køretøjsdata i realtid til live rejseovervågning, forbruksanalyse og løbende forbedring af vores bilmodeller. Det hjælper os med at forfine energiprognoser og rutepræcision.

Gratis API-nøgler findes til integration. Bruger-tokens kræves for indsendelse af data og kan opnås enten via vores OAuth2-flow (anbefalet) eller manuel token-hentning til test og udvikling.

Telemetry-dokumentation Administrer dine telemetry API-nøgler

OAuth2 API

Sikker brugerautentifikation og autorisation

OAuth2 giver en sikker og bekvem måde at identificere og autentificere brugere hos Iternio. For at sætte OAuth2 op skal du bruge en API-nøgle og angive en redirect-URL og et applikationsnavn.

Autorisationsflow

Det første kald returnerer en HTML-side, hvor brugerne kan logge ind og godkende din applikation. Hvis siden åbnes i brugerens standardbrowser, kan login være cachelagret for at gøre processen enklere.

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

Tilladte scopes:

get_telemetry: Hent brugerens seneste telemetri
set_telemetry: Send nye telemetriopdateringer til køretøjet
get_plan: Hent seneste plan i forkortet form (kontakt os for detaljer)
vehicle_history: Hent historiske køreture og ladningssessioner (kontakt os for detaljer)

Svar på din redirect-URI:

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

Token-hentning

Når du har modtaget en autorisationskode, henter du tokenet, som kan gemmes og genbruges efter 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>"
}

Brugeroplysninger

Når du har tokenet, bruger du "me"-endepunktet til at hente brugeroplysninger:

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-baseret integration til forhåndskonfigureret ruteplanlægning

Opret brugerdefinerede URL’er, der starter ABRP med forhåndskonfigurerede ruter, valg af køretøj og planlægningsparametre. Perfekt til indlejring i apps, websites eller navigationssystemer uden API-integration.

Deep links understøtter et bredt udvalg af URL-parametre, herunder start-/slutkoordinater, vejpunkter, bilmodeller, ladningsniveau og brugerpræferencer. Basis-URL: https://abetterrouteplanner.com

Deep-links-dokumentation