API-dokumentáció

Az ABRP vezetőképes EV-routing és úttervező képességeit beépítheted a platformodba. API-kínálatunk zökkenőmentessé teszi a járműfüggő útvonalválasztást, a telemetriát és a deep linkeket.

API-k és integráció

API-csomagunkkal EV-routing, telemetria és deep link integrálása platformodra.

Planning API

v2 - Ajánlott

v1 - Legacy

Járművéges routing teljes EV-tervezési lehetőségekkel

A Planning API kifinomult útvonalakat készít, és bővül az ABRP fejlesztéseivel: energiafelhasználás-modellezés, töltésoptimalizáció, élő forgalom és időjárás alapú tervezés.

Az API REST architektúrát használ JSON válasszal, és mind a régi (v1), mind az új (v2) végpontokat támogatja. Az induló költségek és a csomag díjai integráció és forgalom szerint változnak.

Planning v2 dokumentáció Planning v1 dokumentáció (Legacy)

Telemetry API

Élő járműadat követéshez és modellfrissítéshez

A Telemetry API-val valós időben érkezhetnek a járműadatok: utak követése, fogyasztás-elemzés és folyamatos fejlesztés a modelljeinken. Így finomítjuk az energiabecslést és a routing pontosságát.

Ingyenes API-kulcs igényelhető. Adatküldéshez felhasználói token kell, OAuth2-folyamaton (ajánlott) vagy teszthez kézzel is megszerezhető.

Telemetry dokumentáció Telemetry API-kulcsaid kezelése

OAuth2 API

Biztonságos felhasználói hitelesítés és jogosultság

Az OAuth2 biztonságos, kényelmes módja a felhasználók azonosításának és hitelesítésének az Iterniónál. API-kulcs, visszairányítási URL és alkalmazásnév szükséges a beállításhoz.

Engedélyezési folyamat

Az első hívás HTML oldalt ad, ahol a felhasználó bejelentkezik és jóváhagyja az alkalmazásodat. Ha az alapértelmezett böngészőben nyílik meg, a belépés gyorsítható gyorsítótárral.

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

Engedélyezett scope-ok:

get_telemetry: A felhasználó legfrissebb telemetriájának lekérése
set_telemetry: Új telemetria-felvételek küldése a jármű felé
get_plan: Az utolsó terv tömör formában (részletekért írj nekünk)
vehicle_history: Korábbi utak és töltések lekérése (részletekért írj nekünk)

Válasz a visszairányítási URI-don:

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

Token beszerzése

Engedélyezési kód után kérd le a tokent, tárolhatod és újrahasználhatod szükség szerint.

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

Válasz formátuma:

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

Felhasználói információ

Token után a "me" végponttal kérhetők le a felhasználói adatok:

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

Válasz formátuma:

{
  "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-alapú integráció előkonfigurált útvonaltervhez

Saját URL-ek indíthatják az ABRP-t előre beállított útvonallal, járműválasztással és paraméterekkel. Alkalmas beágyazásra appba, webbe vagy navigációba API nélkül.

A deep linkek széles paramétertámogatást adnak: indulás/cél koordináták, útpontok, járműmodellek, töltöttség és beállítások. Alap URL: https://abetterrouteplanner.com

Deep Links dokumentáció