API dokumentatsioon

Integreeri oma platvormile ABRP võimsad elektrisõidukite marsruutimise ja planeerimise võimalused. Meie laiaulatuslik API-komplekt võimaldab sõidukiteadlike marsruutimis-, telemeetria- ja süvalinkimisfunktsioonide sujuvat integreerimist.

API-d ja integratsioon

Kasuta meie API-de komplekti, et integreerida oma platvormile EV marsruutimine, telemeetria ja süvalinkimine.

Planeerimise API

v2 - soovitatav

v1 - pärand

Sõidukiteadlik marsruutimine koos põhjalike elektrisõidukite planeerimise võimalustega

Meie Planning API pakub keerukat marsruudi planeerimist, mis areneb koos ABRP pidevate täiustustega. Funktsioonide hulka kuuluvad energiatarbimise modelleerimine, laadimise optimeerimine, reaalajas liikluse integreerimine ja ilmateadlik planeerimine.

API kasutab JSON-i väljundiga REST-arhitektuuri ja toetab nii pärand- (v1) kui ka kaasaegseid (v2) lõpp-punkte. Seadistuskulud ja plaanipõhine hinnakujundus sõltuvad sinu integratsioonivajadustest ja kasutusmahust.

v2 Planeerimisdokumentatsioon v1 planeerimisdokumentatsioon (pärand)

Telemeetria API

Reaalajas sõidukiandmed reaalajas jälgimiseks ja autode modelleerimiseks

Telemeetria API võimaldab reaalajas sõidukite andmete edastamist reaalajas teekonna jälgimiseks, tarbimise analüüsiks ja meie automudelite pidevaks täiustamiseks. See aitab meil täpsustada energiaprognoose ja marsruutimise täpsust.

Integreerimiseks on saadaval tasuta API võtmed. Andmete esitamiseks on vaja kasutajatokeneid ja neid saab hankida kas meie OAuth2 voo kaudu (soovitatav) või testimiseks ja arendamiseks käsitsi tokeni hankimise kaudu.

Telemeetria dokumentatsioon Halda oma telemeetria API võtmeid

OAuth2 API

Turvaline kasutaja autentimine ja autoriseerimine

OAuth2 pakub turvalist ja mugavat viisi kasutajate tuvastamiseks ja autentimiseks Iternio abil. OAuth2 seadistamiseks vajad API-võtit ning pead esitama ümbersuunamise URL-i ja rakenduse nime.

Autoriseerimisvoog

Esimene kõne tagastab HTML-lehe, kus kasutajad saavad sisse logida ja sinu rakenduse heaks kiita. Kui see avatakse kasutaja vaikebrauseris, võidakse tema sisselogimine protsessi lihtsustamiseks vahemällu salvestada.

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

Lubatud ulatused:

get_telemetry: Hangi kasutaja uusim telemeetria
set_telemetry: Saada sõidukile uued telemeetriavärskendused
get_plan: Hangi uusim plaan lühendatud kujul (üksikasjade saamiseks võta meiega ühendust)
vehicle_history: Hangi varasemad sõidud ja laadimisseansid (üksikasjade saamiseks võta meiega ühendust)

Vastus sinu ümbersuunamise URI-l:

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

Tokeni hankimine

Kui oled autoriseerimiskoodi kätte saanud, hangi token, mida saab salvestada ja vajadusel uuesti kasutada.

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

Vastuse formaat:

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

Kasutajateave

Pärast tokeni hankimist kasuta kasutajateabe toomiseks lõpp-punkti "me":

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

Vastuse formaat:

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

Süvalingid

URL-põhine integratsioon marsruudi eelkonfigureerimiseks

Loo kohandatud URL-e, mis käivitavad ABRP koos eelkonfigureeritud marsruutide, sõidukivalikute ja planeerimisparameetritega. Ideaalne rakendustesse, veebisaitidele või navigeerimissüsteemidesse manustamiseks ilma API-liidese integreerimiseta.

Süvalingid toetavad laia valikut URL-i parameetreid, sealhulgas lähte- ja sihtkoordinaate, teekonnapunkte, automudeleid, laadimisolekut ja kasutaja eelistusi. Baas-URL: https://abetterrouteplanner.com

Süvalinkide dokumentatsioon