ABRP LogoABRP
    Spustit ABRP

    Dokumentace API

    Na svou platformu propoj výkonné trasování a plánování EV z ABRP. Nabídka rozhraní zahrnuje hladké napojení na trasování závislé na vozidle, telemetrii a hluboké odkazy (deep links).

    API a integrace

    Přes naše rozhraní můžeš do produktu dostat trasování EV, telemetrii a hluboké odkazy.

    Planning API

    v2 – doporučené
    v1 – Legacy

    Trasování zohledňuje vůz a nabízí plné funkce EV plánování

    Planning API staví složité plány tras na neustálém zlepšování ABRP: modeluje spotřebu energie, ladí nabíjení, napojuje se na živou dopravu a bere v potaz počasí.

    API stojí na REST a vrací JSON; podporuje legacy endpointy v1 i moderní v2. Cena nasazení a tarif závisí na hloubce integrace a objemu použití.

    Dokumentace Planning v2 Dokumentace Planning v1 (Legacy)

    Telemetry API

    Živá data vozu pro sledování jízd a modelování

    Telemetry API přenáší data vozu v reálném čase kvůli živému sledování cest, analýze spotřeby i neustálému vylepšování našich modelů aut. Díky tomu zpřesňujeme spotřebu energie i trasování.

    Klíče API dostaneš zdarma. K odesílání dat potřebuješ uživatelské tokeny, ideálně přes OAuth2, ručně třeba pro testy a vývoj.

    Dokumentace Telemetry Spravuj Telemetry API klíče

    OAuth2 API

    Bezpečné přihlašování a oprávnění uživatelů

    OAuth2 je pohodlný způsob, jak uživatele bezpečně identifikovat přes Iternio. Potřebuješ API klíč, zpětnou URL a název aplikace.

    Autorizační tok

    První volání vrátí stránku, kde se uživatel přihlásí a aplikaci schválí. Výchozí prohlížeč může přihlášení držet v mezipaměti, takže další přístup je rychlejší.

    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číst nejnovější telemetrii uživatele
    • set_telemetry: Poslat nová telemetrická data vozidlu
    • get_plan: Načíst poslední plán ve zhuštěné podobě (detaily řešíme osobně)
    • vehicle_history: Historie jízd a nabíjení (detaily řešíme osobně)
    Odpověď na tvé zpětné URI:
    https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>
    Získání tokenu

    Jakmile máš autorizační kód, vydej si token, uložíš ho a budeš ho používat podle potřeby.

    https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>
    Formát odpovědi:
    {
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}
    Údaje o uživateli

    S tokenem pak zavolej endpoint „me“ a vyčti základní informace o uživateli:

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

    Integrace přes adresy URL s přednastaveným plánem

    Slož vlastní odkazy, které otevřou ABRP s trasou, vozem a parametry už připravenými. Ideální do aplikací, webů nebo systémů navigace bez plné napojení na API.

    Deep Links podporuje širokou škálu parametrů URL: začátek a cíl, průjezdní body, typ auta, stav náboje i preference. Základní URL: https://abetterrouteplanner.com

    Dokumentace Deep Links