API dokumentacija

V platformo integriraj zmogljivo EV načrtovanje in usmerjanje ABRP. Naš celovit nabor API omogoča gladko integracijo vožnjam prirejenega načrtovanja, telemetrije in funkcij za globoke povezave.

API in integracija

Dostopaj do našega niza API za integracijo EV načrtovanja, telemetrije in globokih povezav.

Planning API

v2, priporočeno

v1, dediščina

Usmerjanje z vidika vozila in celovito EV načrtovanje

Planning API ponuja izpopolnjeno načrtovanje poti, ki se razvija z stalnimi izboljšavami ABRP. Funkcije vključujejo modeliranje porabe energije, optimizacijo polnjenja, integracijo prometa v realnem času in načrtovanje glede na vreme.

API sledi REST arhitekturi z izhodom JSON in podpira končne točke v1 (dediščina) in modernega v2. Stroški nastavitve in cena glede na načrte se razlikujejo glede na potrebe pri integraciji in obseg.

Dokumentacija za načrtovanje v2 Dokumentacija za načrtovanje v1 (dediščina)

Telemetry API

Živi podatki vozila za sledenje vožnjam in modeliranje vozil

Telemetry API omogoča prenos živih podatkov za sledenje vožnjam v živo, analizo porabe in stalno izpopolnjevanje modelov vozil. Tako izboljšujemo napovedi energije in natančnost načrtovanja.

Brezplačni API ključi so na voljo za integracijo. Za pošiljanje podatkov potrebuješ uporabniške žetone iz OAuth2 toka (priporočeno) ali ročne žetone za razvoj in preskušanje.

Dokumentacija za telemetrijo Upravljanje API ključev za telemetrijo

OAuth2 API

Varna avtentikacija in odobritev

OAuth2 omogoča varen način identifikacije in prijave uporabnikov pri Iternio. Za OAuth2 setup potrebuješ API ključ ter moraš podati preusmeritveni URL in ime aplikacije.

Potek odobritve

Prvi klic vrne HTML stran, kjer se uporabniki lahko prijavijo in odobrijo aplikacijo. Če se odpre v privzetem brskalniku, je lahko prijava shranjena za lažjo nadaljevanje.

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

Dovoleni obsegi:

get_telemetry: Prevzemi najnovejšo telemetrijo uporabnika
set_telemetry: Pošlji nove podatke telemetrije v vozilo
get_plan: Prevzemi zadnji načrt v skrajšani obliki (kontaktiraj nas za podrobnosti)
vehicle_history: Prevzemi zgodovino voženj in sej polnjenja (kontaktiraj nas za podrobnosti)

Odgovor na tvojo preusmeritveno URI:

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

Pridobitev žetona

Ko prejmeš kodo za odobritev, shrani žeton, ga lahko znova uporabljaš po potrebi.

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

Format odgovora:

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

Informacije o uporabniku

Ko imaš žeton, uporabi končno točko "me", da prevzemeš podatke o uporabniku:

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

Format odgovora:

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

Globoke povezave

URL integracija za vnaprej pripravljen načrt poti

Ustvari prilagojene naslove URL, ki zaženejo ABRP z vnaprej nastavljenimi potmi, izborom vozil in parametri načrtovanja. Zelo primerno za vstavljanje v aplikacije, splet ali navigacijo brez API integracije.

Globoke povezave podpirajo širok nabor URL parametrov, vključno s koordinatami izhodišč in ciljev, postanki, modeli avtomobilov, nivojem naboja in nastavitvami. Osnova URL: https://abetterrouteplanner.com

Dokumentacija za globoke povezave