ABRP LogoABRP
    Spustiť ABRP

    Dokumentácia API

    Na svoju platformu napoj výkonné trasovanie a plánovanie EV z ABRP. Rozhrania ponúkajú hladké napojenie na trasovanie závislé od auta, telemetriu a Deep Links.

    API a integrácia

    Cez naše rozhrania dostaneš do produktu trasovanie EV, telemetriu a Deep Links.

    Planning API

    v2 - odporúčané
    v1 - Legacy

    Trasovanie zohľadňuje auto a ponúka plné možnosti EV plánovania

    Planning API stavia zložité plány trás na neustálom zlepšovaní ABRP: modeluje spotrebu energie, ladí nabíjanie, zahrňuje živú dopravu a berie do úvahy počasie.

    API stojí na REST a vracia JSON; podporuje legacy endpointy v1 aj moderné v2. Cena nasadenia a tarif závisia od hĺbky integrácie a objemu použitia.

    Dokumentácia Planning v2 Dokumentácia Planning v1 (Legacy)

    Telemetry API

    Živé dáta auta na sledovanie jázd a modelovanie

    Telemetry API prenáša údaje o aute v reálnom čase na živé sledovanie jázd, analýzu spotreby aj neustále zlepšovanie našich modelov vozidiel. Vďaka tomu spresňujeme spotrebu energie aj trasovanie.

    Kľúče API dostaneš zadarmo. Na odoslanie údajov potrebuješ používateľské tokeny, ideálne cez OAuth2, manuálne napríklad na testy a vývoj.

    Dokumentácia Telemetry Spravuj kľúče Telemetry API

    OAuth2 API

    Bezpečné prihlasovanie a oprávnenia používateľov

    OAuth2 je pohodlný spôsob, ako používateľov bezpečne identifikovať cez Iternio. Potrebuješ API kľúč, spiatočné URL a názov aplikácie.

    Autorizačný tok

    Prvé volanie vráti stránku, kde sa používateľ prihlási a aplikáciu schváli. Predvolený prehliadač môže mať prihlásenie v medzipamäti, ďalší prístup je rýchlejší.

    https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>
    Povolené rozsahy:
    • get_telemetry: Načítať najnovšiu telemetriu používateľa
    • set_telemetry: Poslať nové telemetrické údaje vozidlu
    • get_plan: Načítať posledný plán v skrátenej podobe (podrobnosti osobne)
    • vehicle_history: História jázd a nabíjania (podrobnosti osobne)
    Odpoveď na tvoje spiatočné URI:
    https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>
    Získanie tokenu

    Keď máš autorizačný kód, vyžiadaj si token, uložíš ho a budeš ho používať podľa potreby.

    https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>
    Formát odpovede:
    {
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}
    Údaje o používateľovi

    S tokenom zavolaj endpoint „me“ a vyčítaj základné informácie o používateľovi:

    https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>
    Formát odpovede:
    {
  "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 Links

    Integrácia cez URL s prednastaveným plánom

    Vytvor vlastné odkazy, ktoré spustia ABRP s trasou, autom a parametrami už pripravenými. Ideálne do aplikácií, webov alebo navigačných systémov bez plnej napojenia na API.

    Deep Links podporuje širokú škálu URL parametrov: štart a cieľ, priebežné body, typ auta, stav nabitia aj preferencie. Základná URL: https://abetterrouteplanner.com

    Dokumentácia Deep Links