Dokumentacioni API

Integro aftësitë e fuqishme të drejtimit dhe planifikimit të EV-ve të ABRP në platformën tënde. Paketa jonë gjithëpërfshirëse e API-ve mundëson integrimin e qetë të veçorive të rrugës, telemetrisë dhe lidhjes së thellë për automjetet.

API dhe Integrimi

Përdor paketën tonë të API-ve për të integruar planifikimin e rrugës, telemetrinë dhe lidhjet e thella EV në platformën tënde.

Planning API

v2 - Rekomandohet

v1 - I vjetër

Planifikim i ndërgjegjshëm për automjetet, me aftësi gjithëpërfshirëse të planifikimit të automjeteve elektrike

Planning API ynë ofron planifikim të sofistikuar të rrugës që zhvillohet me përmirësimet e vazhdueshme të ABRP. Veçoritë përfshijnë modelimin e konsumit të energjisë, optimizimin e karikimit, integrimin e trafikut në kohë reale dhe planifikimin e ndërgjegjshëm për motin.

API-ja përdor një arkitekturë REST me dalje JSON dhe mbështet si pikat fundore të vjetra (v1), ashtu edhe ato moderne (v2). Kostot e konfigurimit dhe çmimet për plan ndryshojnë sipas nevojave të tua të integrimit dhe vëllimit të përdorimit.

Dokumentacioni i Planning v2 Dokumentacioni i Planning v1 (i vjetër)

Telemetry API

Të dhëna të automjeteve në kohë reale për gjurmim të drejtpërdrejtë dhe modelim të makinave

Telemetry API mundëson transmetimin e të dhënave të automjeteve në kohë reale për gjurmim të drejtpërdrejtë të udhëtimit, analizë të konsumit dhe përmirësim të vazhdueshëm të modeleve tona të makinave. Kjo na ndihmon të përsosim parashikimet e energjisë dhe saktësinë e planifikimit të rrugës.

Çelësat falas të API-së janë të disponueshëm për integrim. Tokenët e përdoruesit kërkohen për dërgimin e të dhënave dhe mund të merren ose përmes rrjedhës sonë OAuth2 (rekomandohet), ose me rikthim manual të tokenit për testim dhe zhvillim.

Dokumentacioni i telemetrisë Menaxho çelësat e tu API të telemetrisë

OAuth2 API

Siguro vërtetimin dhe autorizimin e përdoruesit

OAuth2 ofron një mënyrë të sigurt dhe të përshtatshme për të identifikuar dhe vërtetuar përdoruesit me Iternio. Për të konfiguruar OAuth2, do të të duhet një çelës API dhe duhet të japësh një URL ridrejtimi dhe emrin e aplikacionit.

Rrjedha e autorizimit

Thirrja e parë kthen një faqe HTML ku përdoruesit mund të identifikohen dhe të miratojnë aplikacionin tënd. Nëse hapet në shfletuesin e parazgjedhur të përdoruesit, identifikimi i tij mund të ruhet në memorie për të thjeshtuar procesin.

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

Fushat e lejuara:

get_telemetry: Merr telemetrinë më të fundit të përdoruesit
set_telemetry: Dërgo përditësime të reja telemetrie në automjet
get_plan: Merr planin më të fundit në formë të kondensuar (na kontakto për detaje)
vehicle_history: Merr udhëtimet historike dhe seancat e karikimit (na kontakto për detaje)

Përgjigja në URI-në tënde të ridrejtimit:

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

Rikthimi i tokenit

Pasi të marrësh një kod autorizimi, merr tokenin që mund të ruhet dhe ripërdoret sipas nevojës.

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

Formati i përgjigjes:

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

Informacioni i përdoruesit

Pas marrjes së tokenit, përdor pikën fundore "me" për të marrë informacionin e përdoruesit:

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

Formati i përgjigjes:

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

Lidhje të thella

Integrim i bazuar në URL për planifikim rruge të parakonfiguruar

Krijo URL të personalizuara që nisin ABRP me rrugë të parakonfiguruara, zgjedhje automjetesh dhe parametra planifikimi. E përkryer për futje në aplikacione, faqe interneti ose sisteme navigimi pa integrim API.

Lidhjet e thella mbështesin një gamë të gjerë parametrash URL, duke përfshirë koordinatat e origjinës/destinacionit, pikat e rrugës, modelet e makinave, gjendjen e karikimit dhe preferencat e përdoruesve. URL-ja bazë: https://abetterrouteplanner.com

Dokumentacioni i lidhjeve të thella