ABRP LogoABRP
    Paleisti ABRP

    API dokumentacija

    Integruok galingas ABRP EV maršruto parinkimo ir planavimo galimybes į savo platformą. Mūsų visapusiškas API rinkinys leidžia sklandžiai integruoti transporto priemones atitinkančias maršruto parinkimo, telemetrijos ir giliųjų nuorodų funkcijas.

    API ir integravimas

    Pasiek mūsų API rinkinį, kad į savo platformą integruotum EV maršruto parinkimą, telemetriją ir giliąsias nuorodas.

    Planavimo API

    v2, rekomenduojama
    v1, pasenusi

    Transporto priemonę žinantis maršrutas su visapusiškomis EV planavimo galimybėmis

    Mūsų planavimo API teikia sudėtingą maršruto planavimą, kuris vystosi kartu su ABRP nuolatiniais patobulinimais. Funkcijos apima energijos suvartojimo modeliavimą, įkrovimo optimizavimą, eismo integravimą realiuoju laiku ir planavimą atsižvelgiant į orą.

    API naudoja REST architektūrą su JSON išvestimi ir palaiko tiek senus (v1), tiek šiuolaikinius (v2) galutinius taškus. Sąrankos išlaidos ir plano kainodara skiriasi atsižvelgiant į tavo integravimo poreikius ir naudojimo apimtį.

    v2 planavimo dokumentacija v1 planavimo dokumentacija (pasenusi)

    Telemetrijos API

    Realaus laiko automobilio duomenys, skirti tiesioginiam stebėjimui ir automobilių modeliavimui

    Telemetrijos API leidžia realiuoju laiku perduoti transporto priemonių duomenis, kad būtų galima tiesiogiai sekti kelionę, analizuoti suvartojimą ir nuolat tobulinti mūsų automobilių modelius. Tai padeda mums tikslinti energijos prognozes ir maršruto parinkimo tikslumą.

    Integracijai prieinami nemokami API raktai. Vartotojo prieigos raktai reikalingi duomenims pateikti ir juos galima gauti naudojant OAuth2 srautą (rekomenduojama) arba rankiniu būdu nuskaitant prieigos raktą, kad būtų galima išbandyti ir tobulinti.

    Telemetrijos dokumentacija Tvarkyk savo telemetrijos API raktus

    OAuth2 API

    Saugus vartotojo autentifikavimas ir autorizacija

    „OAuth2“ suteikia saugų ir patogų būdą identifikuoti ir autentifikuoti vartotojus naudojant „Iternio“. Norint nustatyti OAuth2, tau reikės API rakto, taip pat turi pateikti peradresavimo URL ir programos pavadinimą.

    Autorizacijos srautas

    Pirmasis iškvietimas grąžina HTML puslapį, kuriame vartotojai gali prisijungti ir patvirtinti tavo programą. Jei jis atidaromas numatytojoje vartotojo naršyklėje, jų prisijungimas gali būti išsaugotas talpykloje, kad būtų supaprastintas procesas.

    https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>
    Leidžiamos sritys:
    • get_telemetry: Gauti naujausią vartotojo telemetriją
    • set_telemetry: Siųsti naujus automobilio telemetrijos atnaujinimus
    • get_plan: Gauti naujausią planą sutrumpinta forma (dėl išsamesnės informacijos susisiek su mumis)
    • vehicle_history: Gauti istorines keliones ir įkrovimo seansus (dėl išsamesnės informacijos susisiek su mumis)
    Atsakymas tavo peradresavimo URI:
    https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>
    Prieigos rakto gavimas

    Gavęs autorizacijos kodą, nuskaityk prieigos raktą, kurį gali išsaugoti ir prireikus panaudoti pakartotinai.

    https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>
    Atsakymo formatas:
    {
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}
    Vartotojo informacija

    Gavęs prieigos raktą, naudok „me“ galinį tašką, kad gautum vartotojo informaciją:

    https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>
    Atsakymo formatas:
    {
  "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>"
}

    Giliosios nuorodos

    URL pagrįsta integracija iš anksto sukonfigūruotam maršruto planavimui

    Kurk tinkintus URL, kurie paleidžia ABRP su iš anksto sukonfigūruotais maršrutais, transporto priemonių pasirinkimais ir planavimo parametrais. Puikiai tinka įterpti į programas, svetaines ar navigacijos sistemas be API integracijos.

    Giliosios nuorodos palaiko daugybę URL parametrų, įskaitant kilmės / paskirties koordinates, kelio taškus, automobilių modelius, įkrovimo būseną ir vartotojo nuostatas. Bazinis URL: https://abetterrouteplanner.com

    Giliųjų nuorodų dokumentacija