API dokumentacija

Integriši snažne ABRP mogućnosti EV usmjeravanja i planiranja u svoju platformu. Naš API omogućava besprijekornu integraciju usmjeravanja svjesnog vozila, telemetrije i dubokih linkova.

API-ji i integracija

Pristupi našem skupu API-ja za integraciju EV usmjeravanja, telemetrije i dubokih linkova u svoju platformu.

Planning API

v2, preporučeno

v1, zastarjelo

Usmjeravanje svjesno vozila i sveobuhvatno EV planiranje

Planning API nudi sofisticirano planiranje ruta koje se razvija s kontinuiranim poboljšanjima ABRP-a. Funkcije uključuju modeliranje potrošnje energije, optimizaciju punjenja, integraciju prometa u stvarnom vremenu i planiranje koje uzima u obzir vremenske uslove.

API koristi REST arhitekturu s JSON izlazom i podržava krajnje tačke v1 (zastarjelo) i moderni v2. Troškovi postavljanja i cijena po planu variraju ovisno o potrebama integracije i obimu korištenja.

Dokumentacija za planiranje v2 Dokumentacija za planiranje v1 (zastarjelo)

Telemetry API

Podaci vozila u stvarnom vremenu za praćenje vožnji i modeliranje vozila

Telemetry API omogućava prijenos podataka vozila u stvarnom vremenu za praćenje vožnji uživo, analizu potrošnje i kontinuirano poboljšanje modela vozila. To nam pomaže da preciziramo predviđanja energije i tačnost planiranja.

Besplatni API ključevi su dostupni za integraciju. Za slanje podataka trebaš korisničke tokene iz OAuth2 toka (preporučeno) ili ručne tokene za testiranje i razvoj.

Dokumentacija za telemetriju Upravljaj API ključevima za telemetriju

OAuth2 API

Sigurna autentifikacija i autorizacija

OAuth2 pruža siguran i praktičan način identifikacije i autentifikacije korisnika kod Iternia. Za OAuth2 postavljanje trebaš API ključ i moraš navesti URL za preusmjeravanje i naziv aplikacije.

Tok autorizacije

Prvi poziv vraća HTML stranicu gdje se korisnici mogu prijaviti i odobriti tvoju aplikaciju. Ako se otvori u zadanom pretraživaču, prijava može biti sačuvana radi lakšeg nastavka.

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

Dozvoljeni opsezi:

get_telemetry: Preuzmi najnoviju telemetriju korisnika
set_telemetry: Pošalji nove telemetrijske podatke u vozilo
get_plan: Preuzmi zadnji plan u skraćenom obliku (kontaktiraj nas za detalje)
vehicle_history: Preuzmi historiju vožnji i sesija punjenja (kontaktiraj nas za detalje)

Odgovor na tvoj redirect URI:

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

Preuzimanje tokena

Kad primiš kod autorizacije, preuzmi token koji možeš sačuvati i ponovo koristiti 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 korisniku

Kad imaš token, koristi krajnju tačku "me" za preuzimanje podataka o korisniku:

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

Duboki linkovi

URL integracija za unaprijed konfigurisano planiranje rute

Kreiraj prilagođene URL-ove koji pokreću ABRP s unaprijed konfigurisanim rutama, izborom vozila i parametrima planiranja. Idealno za ugradnju u aplikacije, web stranice ili navigacijske sisteme bez API integracije.

Duboki linkovi podržavaju širok raspon URL parametara, uključujući koordinate polazišta i odredišta, usputne stanice, modele automobila, nivo napunjenosti i korisničke postavke. Osnovni URL: https://abetterrouteplanner.com

Dokumentacija za duboke linkove