API‑dokumentaatio

Integroi ABRP:n tehokkaat EV‑reititys- ja suunnittelutoiminnot omaan alustaasi. Kattava rajapinta‑kokonaisuumme mahdollistaa ajoneuvo‑tietoisen reitityksen, telemetrian ja syvälinkityksen saumattomasti.

API:t ja integraatio

Käytä rajapinta‑kokonaisuuttamme integroidaksesi EV‑reitityksen, telemetrian ja syvälinkit omaan järjestelmääsi.

Planning API

v2 – suositeltu

v1 – legacy

Ajoneuvo‑tietoinen reititys ja kattava EV‑suunnittelu

Planning API tarjoaa kehittynyttä reittisuunnittelua ja kehittyy ABRP:n jatkuvan parannustyön mukaan. Mukana energiankulutusmallitus, latausoptimointi, live‑liikennetiedot ja säätietoinen planaus.

Rajapinta noudattaa REST‑arkkitehtuuria ja palauttaa JSON‑dataa; käytettävissä ovat sekä legacy (v1) että uusi (v2) päätepisteiden sarja. Käyttöönoton kustannukset ja hinnoittelu vaihtelevat tarpeittesi ja määrän mukaan.

v2 Planning ‑dokumentaatio v1 Planning ‑dokumentaatio (legacy)

Telemetry API

Ajoneuvon reaaliaikainen data live‑seurantaan ja mallinnukseen

Telemetry API välittää ajoneuvotietoa reaaliajassa: matkan seuraamiseen, kulutusanalyyseihin ja autokantamallejemme hiomiseen. Näin tarkennamme energiaennusteita ja reittitarkkuutta.

Ilmaisia API‑avaimia löytyy integrointiin. Datan lähetys tarvitsee käyttäjän tunnuksen, saat sen parhaiten OAuth2‑virtamme kautta (suositus), tai käsin testaukseen ja kehitykseen.

Telemetry‑dokumentaatio Hallinnoi Telemetry API ‑avaimiasi

OAuth2 API

Turvallinen käyttäjän tunnistus ja käyttölupa

OAuth2 on turvallinen tapa tunnistaa ja valtuuttaa käyttäjät Iternion palvelussa. Otettaksesi se käyttöön tarvitset API‑avaimen sekä uudelleenohjaus‑URL:in ja sovelluksen nimen.

Valtuutusvirta

Ensimmäinen pyyntö palauttaa HTML‑sivun, jossa käyttäjä kirjautuu ja hyväksyy sovelluksesi. Kun sivun avaa oletusselaimeen, istunto saattaa olla välimuistissa.

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

Sallitut scopes:

get_telemetry: Hae käyttäjän viimeisin telemetria
set_telemetry: Lähetä uusia telemetriapäivityksiä ajoneuvolle
get_plan: Hae uusin suunnitelma tiivistettynä (yksityiskoihin ota yhteyttä)
vehicle_history: Hae historiaan tallentuneet ajot ja lataussessiot (yksityiskoihin ota yhteyttä)

Vastaus redirect‑URI osoitteeseesi:

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

Tokentin haku

Kun olet saanut valtuutuskoodin, hae tunniste (token), jonka voit tallentaa ja käyttää uudelleen tarpeen mukaan.

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

Vasteformaatti:

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

Käyttäjätiedot

Tokentin jälkeen voit käyttää "me"‑endpointtia käyttäjätietojen noutamiseen:

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

Vasteformaatti:

{
  "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‑integraatio valmiilla reittiasetuksilla

Rakenna URL:eja jotka käynnistävät ABRP:n valmiilla reittivalinnoilla, autoilla ja suunnitelman parametreilla, upota sovelluksiin, sivustoille tai navigaatiotuotteisiin ilman kokonaista REST‑rajapinta‑integraatiota.

Deep Links tukevat laajasti URL‑parametreja: alkupisteet ja koordinaatit, välipisteet, autot, lataustaso ja käyttöasetukset. Perusosoite: https://abetterrouteplanner.com

Deep Links ‑dokumentaatio