API dokumentacija

    Integriši ABRP-ove moćne mogućnosti EV rutiranja i planiranja u svoju platformu. Naš sveobuhvatni API paket omogućava besprijekornu integraciju rutiranja sa sviješću o vozilu, telemetrije i funkcija dubokog povezivanja.

    API-ji i integracija

    Pristupi našem paketu API-ja da integrišeš EV rutiranje, telemetriju i duboko povezivanje u svoju platformu.

    Planning API

    v2 - Preporučeno
    v1 - Naslijeđeno

    Rutiranje sa sviješću o vozilu uz sveobuhvatne mogućnosti EV planiranja

    Naš Planning API pruža sofisticirano planiranje rute koje se razvija uz ABRP-ova stalna poboljšanja. Funkcije uključuju modelovanje potrošnje energije, optimizaciju punjenja, integraciju saobraćaja u realnom vremenu i planiranje sa sviješću o vremenu.

    API koristi REST arhitekturu sa JSON izlazom i podržava i naslijeđene (v1) i moderne (v2) krajnje tačke. Troškovi podešavanja i cijene po planu variraju u zavisnosti od tvojih potreba za integracijom i obima korišćenja.

    Telemetry API

    Podaci o vozilu u realnom vremenu za praćenje uživo i modelovanje vozila

    Telemetry API omogućava prenos podataka o vozilu u realnom vremenu za praćenje putovanja uživo, analizu potrošnje i kontinuirano poboljšanje naših modela vozila. Ovo nam pomaže da usavršimo predviđanja energije i tačnost rutiranja.

    Besplatni API ključevi su dostupni za integraciju. Korisnički tokeni su potrebni za slanje podataka i mogu se dobiti kroz naš OAuth2 tok (preporučeno) ili ručnim preuzimanjem tokena za testiranje i razvoj.

    OAuth2 API

    Sigurna autentifikacija i autorizacija korisnika

    OAuth2 pruža siguran i zgodan način da identifikuješ i autentifikuješ korisnike pomoću Iternio-a. Da bi podesio OAuth2, treba ti API ključ i moraš navesti URL za preusmjeravanje i naziv aplikacije.

    Tok autorizacije

    Prvi poziv vraća HTML stranicu na kojoj korisnici mogu da se prijave i odobre tvoju aplikaciju. Ako se otvori u podrazumijevanom pregledaču korisnika, njegova prijava može biti keširana radi pojednostavljenja procesa.

    https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>
    Dozvoljeni opsezi:
    • get_telemetry: Preuzmi najnoviju telemetriju korisnika
    • set_telemetry: Pošalji nova ažuriranja telemetrije u vozilo
    • get_plan: Preuzmi najnoviji plan u sažetom obliku (kontaktiraj nas za detalje)
    • vehicle_history: Preuzmi istorijske vožnje i sesije punjenja (kontaktiraj nas za detalje)
    Odgovor na tvom URI-ju za preusmjeravanje:
    https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>
    Preuzimanje tokena

    Kad primiš autorizacioni kod, preuzmi token koji se može sačuvati i ponovo koristiti po potrebi.

    https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>
    Format odgovora:
    {
      "access_token": "<the created token>",
      "token_type": "bearer",
      "state": "<your supplied state>"
    }
    Informacije o korisniku

    Nakon dobijanja tokena, koristi krajnju tačku „me“ da preuzmeš informacije o korisniku:

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

    Duboki linkovi

    Integracija zasnovana na URL-u za unaprijed konfigurisano planiranje rute

    Kreiraj prilagođene URL-ove koji pokreću ABRP sa unaprijed konfigurisanim rutama, izborom vozila i parametrima planiranja. Savršeno za ugrađivanje u aplikacije, sajtove ili navigacione sisteme bez API integracije.

    Duboki linkovi podržavaju širok spektar URL parametara, uključujući koordinate polazišta/odredišta, putne tačke, modele vozila, stanje napunjenosti i korisničke postavke. Osnovni URL: https://abetterrouteplanner.com