Documentație API

Integrează în platforma ta rutarea și planificarea puternice pentru EV oferite de ABRP. Suite-ul nostru complet de API-uri îți permite integrarea fluidă a rutării conștiente de vehicul, telemetriei și funcționalității de deep linking.

API-uri și integrare

Accesezi suite-uri de API pentru rutare EV, telemetrie și deep link-uri integrate în produsul tău.

Planning API

v2 - Recomandat

v1 - Legacy

Rutare conștientă de vehicul și planificare EV completă.

Planning API livrează planificare de rute inteligentă, care evoluționează odată cu îmbunătățirile continue ale ABRP: modelare consum, optimizarea încărcării, integrare cu trafic în timp real și planificare sensibilă la vreme.

API-ul folosește arhitectură REST și răspunsuri JSON și suportă atât endpoint-uri vechi (v1), cât și moderne (v2). Costurile inițiale și prețul per plan variază în funcție de nevoi și volum.

Documentație Planning v2 Documentație Planning v1 (Legacy)

Telemetry API

Date de la vehicul în timp real pentru urmărirea curselor și modelare.

Telemetry API permite transmiterea în timp real a datelor de la mașină pentru monitoringul călătoriei, analiza consumului și îmbunătățirea continuă a modelelor. Ne ajută să rafinăm predicțiile energetice și precizia rutelor.

Oferim chei de API gratuite pentru integrare. Pentru transmitere ai nevoie de token-uri de utilizator, pe care le obții prin fluxul OAuth2 (recomandat) sau manual, pentru teste și dezvoltare.

Documentație Telemetry Gestionează cheile Telemetry API

OAuth2 API

Autentificare și autorizare sigure pentru utilizatori

OAuth2 oferă un mod sigur și comod să identifici și autentifici utilizatorii cu Iternio. Pentru configurare ai nevoie de o cheie API, plus un URL de redirecționare și numele aplicației.

Flux de autorizare

Primul apel întoarce o pagină HTML unde utilizatorii se pot autentifica și aprobă aplicația ta. Dacă este deschis în browserul implicit, autentificarea poate fi reținută ca să simplifice pașii următori.

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

Scope-uri acceptate:

get_telemetry: Citești ultima telemetrie disponibilă a utilizatorului
set_telemetry: Trimiți actualizări noi de telemetrie către vehicul
get_plan: Obții ultimul plan în formă condensată (scrie-ne pentru detalii)
vehicle_history: Citești curse și sesiuni de încărcare din trecut (scrie-ne pentru detalii)

Ce primești la redirect URI:

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

Extragerea token-ului

După ce primești codul de autorizare, obții token-ul, pe care îl poți stoca și reutiliza ori de câte ori este nevoie.

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

Format răspuns:

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

Date despre utilizator

După token, apelezi endpoint-ul „me” pentru a citi informații despre utilizator:

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

Format răspuns:

{
  "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 link-uri

Integrare cu URL-uri pentru configurări gata făcute

Construiești URL-uri care deschid ABRP cu ruta, mașina și parametrii de planificare pregătită din timp, ideal pentru aplicații, site-uri sau navigare fără integrare API completă.

Deep link-urile suportă multe parametri: coordonate origine și destinație, puncte intermediare, model auto, nivel baterie, preferințe. URL-ul de bază: https://abetterrouteplanner.com

Documentație deep links