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

Интегрирай могъщото EV маршрутизиране и планиране на ABRP в платформата си. Пълният ни комплект от API улеснява безшевното вграждане на маршрутизация, осведомена за автомобила, телеметрия и deep linking.

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

Достъп до API за EV маршрутизация, телеметрия и deep linking в твоята платформа.

Planning API

v2 · препоръчително

v1 · наследено

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

Planning API дава задълбочено планиране, което следва постоянните подобрения на ABRP: модели на потребление, оптимизация на зареждания, жив трафик и времеви профил.

API е REST с JSON поддръжка за наследени (v1) и модерни (v2) точки. Настройките и тарифите зависят от интеграцията и обема.

Документация за Planning API v2 Документация за Planning API v1 (наследено)

Telemetry API

Реални данни от автомобила за проследяване и моделиране

Telemetry API предава данни от колата за следване на пътуването, анализ на потребление и постоянно подобрение на моделите ни за по-точни прогнози и маршрути.

Безплатни ключове са налични за интеграция. За качване на данни нужен е потребителски токен през нашия OAuth2 (препоръчително) или ръчно за тест.

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

OAuth2 API

Сигурна идентификация и оторизация на потребители

OAuth2 ти дава сигурен и удобен начин да идентифицираш и оторизираш потребители срещу Iternio. За настройка са ти нужни API ключ, redirect URL и име на приложение.

Поток на оторизация

Първото извикване показва HTML страница, където потребителят се логва и одобрява приложението ти. В браузъра му кешът може да ускори процеса.

https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>

Разрешени обхвати:

get_telemetry: Взима последна телеметрия на потребителя
set_telemetry: Изпраща нови записи телеметрия за автомобила
get_plan: Взима последния план в компактен вид (свържи се с нас)
vehicle_history: История на пътуванията и зарежданията (свържи се с нас)

Отговор на твоя redirect URI:

https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>

Получаване на токен

След authorization 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>"
}

Информация за потребителя

С токена използвай крайна точка „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 поддържат множество параметри: координати, точки през които минава пътя, модел автомобил, SoC и настройки. Базов URL: https://abetterrouteplanner.com

Документация за deep links