ABRP LogoABRP
    Uruchom ABRP

    Dokumentacja API

    Wykorzystaj w platformie zaawansowane trasowanie i planowanie EV z ABRP. Nasza rodzina API umożliwia płynną integrację tras świadomych pojazdu, telemetrii i Deep Links.

    API i integracja

    Skorzystaj z naszych API, by wbudować trasowanie EV, telemetrię i deep linki w swoją platformę.

    Planning API

    v2 - Recommended
    v1 - Legacy

    Trasowanie świadome pojazdu z pełnym planowaniem EV

    Planning API daje zaawansowane planowanie tras, które rozwija się wraz ze stałymi ulepszeniami ABRP: model zużycia energii, optymalizacja ładowania, ruch w czasie rzeczywistym i planowanie z uwzględnieniem pogody.

    Architektura to REST z wynikiem JSON; obsługujemy punkty końcowe legacy (v1) i nowe (v2). Koszt wdrożenia i ceny per plan zależą od potrzeb integracji i wolumenu.

    Dokumentacja Planning v2 Dokumentacja Planning v1 (Legacy)

    Telemetry API

    Dane pojazdu na żywo do śledzenia tras i modeli aut

    Telemetry API przekazuje dane pojazdu na żywo: śledzenie podróży, analiza zużycia i nieustanne doskonalenie modeli pojazdów. Dzięki temu dopracowujemy prognozy energii i dokładność tras.

    Do integracji są darmowe klucze API. Do wysyłania danych potrzebne są tokeny użytkownika, przez nasz OAuth2 (zalecane) lub ręcznie do testów i rozwoju.

    Dokumentacja Telemetry API Zarządzaj kluczami Telemetry API

    OAuth2 API

    Bezpieczna autoryzacja użytkowników

    OAuth2 to wygodny, bezpieczny sposób identyfikacji użytkowników przy Iternio. Do konfiguracji potrzebujesz klucza API, adresu przekierowania i nazwy aplikacji.

    Przepływ autoryzacji

    Pierwsze żądanie zwraca stronę HTML, gdzie użytkownik loguje się i zatwierdza aplikację. Jeśli otwiera się w domyślnej przeglądarce, logowanie może zostać zapamiętane dla uproszczenia.

    https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>
    Dozwolone zakresy:
    • get_telemetry: Pobranie najnowszej telemetrii użytkownika
    • set_telemetry: Wypchnięcie nowych danych telemetrii do pojazdu
    • get_plan: Pobranie ostatniego planu w formie skróconej (szczegóły po kontakcie)
    • vehicle_history: Historia przejazdów i sesji ładowania (szczegóły po kontakcie)
    Odpowiedź na Twoim URI przekierowania:
    https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>
    Pobieranie tokena

    Po otrzymaniu kodu autoryzacji pobierz token, który możesz zapisać i wielokrotnie używać.

    https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>
    Format odpowiedzi:
    {
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}
    Dane użytkownika

    Po uzyskaniu tokena wywołaj endpoint „me”, by pobrać informacje o użytkowniku:

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

    Integracja przez URL z gotowym planem trasy

    Twórz niestandardowe adresy URL, które uruchomią ABRP z ustawioną trasą, pojazdem i parametrami planowania. Idealne do osadzenia w aplikacjach, stronach czy bez integracji przez API.

    Deep linki akceptują wiele parametrów: orig/dest, punkty pośrednie, modele, stan naładowania, preferencje. Bazowy URL: https://abetterrouteplanner.com

    Dokumentacja Deep Links