API документација

Интегрирајте ги моќните можности за насочување и планирање на EV на ABRP во вашата платформа. Нашиот сеопфатен пакет на API овозможува беспрекорна интеграција на карактеристиките за рутирање, телеметрија и длабоко поврзување свесни за возилото.

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

Пристапете до нашиот пакет на API за интегрирање на рутирање, телеметрија и длабоко поврзување со ЕВ во вашата платформа.

API за планирање

v2 - Препорачано

v1 - Наследство

Рутирање свесно за возилото со сеопфатни можности за планирање на ЕВ

Нашиот API за планирање обезбедува софистицирано планирање на маршрутата што се развива со континуираните подобрувања на ABRP. Карактеристиките вклучуваат моделирање на потрошувачката на енергија, оптимизација на полнење, интеграција на сообраќајот во реално време и планирање со временска прогноза.

API користи REST архитектура со JSON излез и поддржува и наследни (v1) и модерни (v2) крајни точки. Трошоците за поставување и цените по план се разликуваат врз основа на вашите потреби за интеграција и обемот на користење.

v2 Планска документација v1 Планска документација (наследство)

Telemetry API

Податоци за возилото во реално време за следење во живо и моделирање на автомобил

Telemetry API овозможува пренос на податоци за возилото во реално време за следење на патувањата во живо, анализа на потрошувачката и постојано подобрување на нашите модели на автомобили. Ова ни помага да ги усовршиме енергетските предвидувања и точноста на насочувањето.

Достапни се бесплатни API клучеви за интеграција. Корисничките токени се потребни за доставување податоци и може да се добијат или преку нашиот тек на OAuth2 (се препорачува) или преку рачно пребарување на токени за тестирање и развој.

Документација за телеметрија Управувајте со вашите клучеви за API за телеметрија

OAuth2 API

Безбедна автентикација и овластување на корисникот

OAuth2 обезбедува безбеден и удобен начин за идентификување и автентикација на корисниците со Iternio. За да поставите OAuth2, ќе ви треба клуч API и мора да обезбедите 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: Враќање на историски дискови и сесии за полнење (контактирајте не за детали)

Одговор на вашиот 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>"
}

Информации за корисникот

Откако ќе го добиете токенот, користете ја крајната точка „јас“ за да ги вратите корисничките информации:

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.

Длабоките врски поддржуваат широк опсег на параметри на URL, вклучувајќи координати за потекло/одредиште, точки на движење, модели на автомобили, состојба на полнење и преференции на корисникот. Основен URL: https://abetterrouteplanner.com

Документација за длабоки врски