ABRP LogoABRP
    Открыть ABRP

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

    Встройте возможности EV-маршрутизации и планирования ABRP в платформу. Комплект API даёт маршрутизацию с учётом машины, телеметрию и диплинки.

    API и интеграция

    Используйте наши API, чтобы добавить EV-маршрутизацию, телеметрию и диплинки в свою платформу.

    Planning API

    v2, рекомендуется
    v1, устаревший

    Маршрутизация с учётом машины и полным набором планирования EV

    Planning API задаёт точное планирование и развивается вместе с ABRP. Есть модель расхода, оптимизация зарядок, живой трафик и план с учётом погоды.

    Архитектура REST, ответ JSON, поддерживаются v1 и v2. Стартовые и помесячные тарифы зависят от интеграции и объёма запросов.

    Документация Planning API v2 Документация Planning API v1 (legacy)

    Telemetry API

    Живые данные автомобиля для трекинга и моделей

    Telemetry API передаёт данные в реальном времени: отслеживание поездок, анализ расхода и уточнение моделей. Так мы улучшаем прогноз энергии и точность маршрутов.

    Есть бесплатные ключи для интеграции. Чтобы отправлять данные, нужны пользовательские токены: через OAuth2 (предпочтительно) или вручную для разработки и тестов.

    Документация Telemetry Управление ключами Telemetry API

    OAuth2 API

    Безопасная авторизация пользователей

    OAuth2 даёт удобный способ авторизации в Iternio. Для настройки нужен API-ключ, redirect URI и название приложения.

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

    Первый вызов отдаёт HTML-страницу входа и согласия. Если браузер по умолчанию, вход может сохраниться и упростить повторный заход.

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

    После кода авторизации забрать токен, его можно сохранять и использовать повторно.

    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>"
}

    Диплинки

    URL для старта планирования с готовыми параметрами

    Соберите URL, который открывает ABRP с маршрутом, машиной и настройками. Удобно для встройки без полноценной интеграции API.

    Поддерживается много параметров: координаты старт/финиш, промежуточные точки, модель машины, SoC и настройки. Базовый URL: https://abetterrouteplanner.com

    Документация Deep Links