API dokumentacija

Integriši moćne ABRP mogućnosti EV rutiranja i planiranja u svoju platformu. Naš sveobuhvatan skup API-ja omogućava neometanu integraciju rutiranja prilagođenog vozilu, telemetrije i funkcija dubokog povezivanja.

API-ji i integracija

Pristupi našem skupu API-ja da integrišeš EV rutiranje, telemetriju i duboko povezivanje u svoju platformu.

Planning API

v2 - preporučeno

v1 - zastarelo

Rutiranje prilagođeno vozilu sa sveobuhvatnim EV mogućnostima planiranja

Naš Planning API pruža sofisticirano planiranje rute koje se razvija sa stalnim poboljšanjima ABRP-a. Funkcije uključuju modeliranje potrošnje energije, optimizaciju punjenja, integraciju saobraćaja u realnom vremenu i planiranje koje uzima u obzir vremenske prilike.

API koristi REST arhitekturu sa JSON izlazom i podržava i zastarele (v1) i moderne (v2) krajnje tačke. Troškovi podešavanja i cena po planu zavise od tvojih potreba za integracijom i obima upotrebe.

v2 dokumentacija za planiranje v1 dokumentacija za planiranje (zastarelo)

Telemetry API

Podaci vozila u realnom vremenu za praćenje vožnje uživo i modeliranje vozila

Telemetry API omogućava prenos podataka vozila u realnom vremenu za praćenje vožnje uživo, analizu potrošnje i stalno poboljšavanje naših modela vozila. Tako usavršavamo predviđanja energije i tačnost rutiranja.

Besplatni API ključevi su dostupni za integraciju. Za slanje podataka potrebni su korisnički tokeni, koje možeš dobiti kroz naš OAuth2 tok (preporučeno) ili ručnim preuzimanjem tokena za testiranje i razvoj.

Dokumentacija za telemetriju Upravljaj svojim API ključevima za telemetriju

OAuth2 API

Bezbedna autentifikacija i autorizacija korisnika

OAuth2 pruža bezbedan i praktičan način da identifikuješ i autentifikuješ korisnike kod Iternio. Za podešavanje OAuth2 potreban ti je API ključ i moraš da navedeš URL za preusmeravanje i ime aplikacije.

Tok autorizacije

Prvi poziv vraća HTML stranicu na kojoj korisnici mogu da se prijave i odobre tvoju aplikaciju. Ako se otvori u podrazumevanom pregledaču korisnika, prijava može biti keširana radi pojednostavljenja procesa.

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 podatke telemetrije u vozilo
get_plan: Preuzmi najnoviji plan u skraćenom obliku (kontaktiraj nas za detalje)
vehicle_history: Preuzmi istoriju vožnji i sesija punjenja (kontaktiraj nas za detalje)

Odgovor na tvoj URI za preusmeravanje:

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

Preuzimanje tokena

Kada dobiješ kôd za autorizaciju, preuzmi token koji možeš da sačuvaš i ponovo koristiš 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

Kada dobiješ token, koristi krajnju tačku „me“ da preuzmeš informacije 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>"
}

Duboke veze

Integracija zasnovana na URL-u za unapred podešeno planiranje rute

Napravi prilagođene URL-ove koji pokreću ABRP sa unapred podešenim rutama, izborom vozila i parametrima planiranja. Savršeno za ugrađivanje u aplikacije, sajtove ili navigacione sisteme bez API integracije.

Duboke veze podržavaju širok opseg URL parametara, uključujući koordinate polaska/odredišta, međutačke, modele vozila, nivo napunjenosti i korisničke postavke. Osnovni URL: https://abetterrouteplanner.com

Dokumentacija za duboke veze