API dokumentācija

Integrē platformā ABRP jaudīgo elektromobiļu maršķēšanu un plānošanu. Mūsu API komplekts ļauj vienkārši integrēt auto apzinātu maršķēšanu, telemetriju un saišu funkcijas.

API un integrācija

Izmanto mūsu API, lai platformā pieslēgtu elektroauto maršķēšanu, telemetriju un saišu integrācijas.

Planning API

v2, ieteicamais

v1, mantotais

Auto zinoša maršķēšana ar pilnu elektroauto plānošanu

Planning API piedāvā izsmalcinātu maršķu plānošanu kopā ar ABRP nepārtrauktajiem uzlabojumiem, tostarp enerģijas patēriņa modelēšanu, uzlādes optimizāciju, satiksmes datus reāllaikā un laikapstākļiem sensitīvu plānāšanu.

API balstās REST arhitektūrā izvadam JSON forma un atbalsta gan vecākos (v1), gan jaunos (v2) galapunktos. Palaišanas izmaksas un cenas vienam plānā atkarīgas no integrācijas apjoma un noslodzes.

Planning API v2 dokumentācija Planning API v1 dokumentācija (mantotais)

Telemetry API

Reāllaika transportlīdzekļa dati ceļa izsekšanai un modeļu uzlabošanai

Telemetry API ļauj sūtīt auto datus reāllaikā, sekot ceļošanai, analizēt patēriņu un uzlabot mūsu auto modeļus. Tas palīdz precizēt enerģijas prognozes un maršķu precizitāti.

Bezmaksas API atslēgas ir pieejamas integrācijai. Lai nosūtītu datus, vajadzīgs lietotāja pilnvaras žetons, ko visērtāk iegūst ar OAuth2 plūsmu, testiem un izstrādei to var arī iegūt manuāli.

Telemetrijas dokumentācija Pārvaldi savas telemetrijas API atslēgas

OAuth2 API

Droša lietotāju autentifikācija un autorizācija.

OAuth2 ļauj droši un ērti identificēt un autorizēt lietotājus pie Iternio. Lai pieslēgtu OAuth2, tev nepieciešama API atslēga, novirzes URL un lietojuma nosaukums.

Autorizācijas plūsma

Pirmais izsaukums atgriež HTML lapu, kur lietotājs pieslēdzas un apstiprina tavu lietojumu. Ja lapu atvēr savā parastajā pārlūkā, pieslēgšanās var būt saglabāta procesa vienkāršošanai.

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

Atļautie scopes:

get_telemetry: Ielasīt lietotāja jaunāko telemetriju
set_telemetry: Sūtīt jaunos telemetrijas datus uz transportlīdzekli
get_plan: Saņemt jaunāko maršķa plānu saīsinātā formātā (sīkāk, sazinies ar mums)
vehicle_history: Saņemt vēsturiskās braucienu un uzlādes sesijas (sīkāk, sazinies ar mums)

Atbilde tavā novirzes URI:

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

Žetona ieguve

Saņēmis autorizācijas kodu, iegūsti žetonu, kuru saglabāt un atkārtoti lietot, kad tas nepieciešams.

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

Atbildes formāts:

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

Lietotāja informācija

Pēc žetona ieguves izmanto gala punktu „me”, lai ielasītu lietotāja datus:

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

Atbildes formāts:

{
  "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 integrācija ar iepriekš sagatavotu maršķu plānošanu

Izveido pielāgotus URL, kas palaiž ABRP ar iepriekš iestatītiem maršķiem, auto izvēli un plānošanas parametriem. Noderīgi ieguldīšanai lietotnēs, vietnēs vai navigācijas risinājumos bez pilnas API integrācijas.

Saites atbalsta plašu URL parametru kopu, tai skaitā sākuma un galapunkta koordinātes, ceļā posmus, auto modeļus, uzlādes līmeni un lietotāja preferences. Pamata URL: https://abetterrouteplanner.com

Deep Links dokumentācija