API dokumentacija

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

API-ji i integracija

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

Planning API

v2 - Preporučeno

v1 - Naslijeđeno

Usmjeravanje svjesno vozila s potpunim mogućnostima EV planiranja

Naš Planning API pruža sofisticirano planiranje ruta koje se razvija uz stalna poboljšanja ABRP-a. Značajke uključuju modeliranje potrošnje energije, optimizaciju punjenja, integraciju prometa u stvarnom vremenu i planiranje s obzirom na vrijeme.

API koristi REST arhitekturu s JSON izlazom i podržava naslijeđene (v1) i moderne (v2) krajnje točke. Troškovi postavljanja i cijena po planu razlikuju se ovisno o tvojim potrebama za integracijom i opsegu korištenja.

Dokumentacija za planiranje v2 Dokumentacija za planiranje v1 (naslijeđeno)

Telemetry API

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

Telemetry API omogućuje prijenos podataka vozila u stvarnom vremenu za praćenje vožnji uživo, analizu potrošnje i stalno poboljšavanje naših modela vozila. To nam pomaže precizirati procjene energije i točnost planiranja.

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

Dokumentacija za telemetriju Upravljaj svojim API ključevima za telemetriju

OAuth2 API

Sigurna autentifikacija i autorizacija korisnika

OAuth2 pruža siguran i praktičan način za identifikaciju i autentifikaciju korisnika kod Iternija. Za postavljanje OAuth2 trebaš API ključ te moraš navesti URL za preusmjeravanje i naziv aplikacije.

Tok autorizacije

Prvi poziv vraća HTML stranicu na kojoj se korisnici mogu prijaviti i odobriti tvoju aplikaciju. Ako se otvori u korisnikovom zadanom pregledniku, prijava može biti spremljena radi pojednostavljenja postupka.

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

Dopušteni opsezi:

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

Odgovor na tvom URI-ju za preusmjeravanje:

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

Dohvaćanje tokena

Kad primiš kod za autorizaciju, dohvati token koji možeš spremiti i ponovno 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

Nakon što dobiješ token, koristi krajnju točku "me" za dohvaćanje informacija 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 poveznice

Integracija putem URL-a za unaprijed konfigurirano planiranje rute

Stvori prilagođene URL-ove koji pokreću ABRP s unaprijed konfiguriranim rutama, odabirom vozila i parametrima planiranja. Idealno za ugradnju u aplikacije, web stranice ili navigacijske sustave bez API integracije.

Duboke poveznice podržavaju širok raspon URL parametara, uključujući koordinate polazišta i odredišta, međupostaje, modele vozila, razinu napunjenosti i korisničke postavke. Osnovni URL: https://abetterrouteplanner.com

Dokumentacija za duboke poveznice