ABRP LogoABRP
    Запуск ABRP

    Документація API

    Підключай до своєї платформи потужне планування й маршрутизацію EV з ABRP. Пакет охоплює маршрути з урахуванням авто, телеметрію та deep links без зайвого головного болю для команди.

    API та інтеграції

    Бери наші API й додай у продукт маршрутизацію EV, телеметрію й deep linking без власної збірки з нуля.

    Planning API

    v2, рекомендований
    v1 legacy

    Роутинг, що пам'ятає про авто й енергію повного циклу

    Planning API дає складні маршрути, які доростають разом із покращеннями ABRP: моделі енергоспоживання, оптимізація стопів, трафік у реалі та підлаштування під погоду.

    Стек тримається на REST + JSON із підтримкою класичних v1 і новіших v2 ендпоінтів. Вартість старту та тарифікація залежать від складності потоків і того, як багато планування тягне інтеграція.

    Доки Planning API v2 Доки Planning API v1 (legacy)

    Telemetry API

    Live-дані авто для треків поїздок і живих моделей машин

    Telemetry API ганяє живі параметри машини, щоб бачити хід поїздки, робити висновки щодо споживання та відточувати наші профілі транспортних засобів. Так ми підтягуємо точність пробігу та маршрутів для тебе і всіх інших водіїв.

    Ключі API доступні безкоштовно для інтеграції. На сабміт даних знадобиться user token через OAuth2 (рекомендований шлях) або штучним шляхом для дев середовища.

    Документи Telemetry Керуй своїми telemetry API-ключами

    OAuth2 API

    Авторизація без дурної магії

    OAuth2 дає охайний місток до аккаунтів Iternio. На старт потрібен API key, повернення redirect URL та ім'я апки для консенту.

    Потік авторизації

    Перший виклик віддає HTML, де ти або твої юзери логінються й підписуються на апку. Якщо браузер той же, логін може бути закешений, процес простіший із разу на раз.

    https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>
    Дозволені scopes:
    • get_telemetry: Забираєш найсвіжішу телеметрію користувача
    • set_telemetry: Пушиш нові оновлення телеметрії назад у машину
    • get_plan: Береш останній укорочений план (деталі, пиши нам)
    • vehicle_history: Історія поїздок і сеансів зарядки (деталі, пиши нам)
    Відповідь на redirect URI:
    https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>
    Отримання токена

    Коли авторизаційний код у кишені, витягуй bearer token для повторних викликів із твого сервісу.

    https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>
    Формат відповіді:
    {
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}
    Інфо про користувача

    Після токена бийся в endpoint `me`, щоб витягнути опис профілю користувача:

    https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>
    Формат відповіді:
    {
  "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

    URL-лаунч із готовими пресетами маршруту

    Створюй власні лінки, що одразу відкривають ABRP із заданими точками, авто й параметрами планування. Зручно для вшивання в апки, сайти чи навігаційні платформи без повного API-проєкту.

    Deep Links ковтають широкий спектр query: координати старту і фінішу, waypoints, модель авто, SoC користувача та преференси. Базовий домен: https://abetterrouteplanner.com

    Документи Deep Links