Дакументацыя API

Інтэгруй магутныя магчымасці ABRP па EV-маршрутызацыі і планаванні ў сваю платформу. Наш поўны набор API дае бесперабойную інтэграцыю маршрутызацыі з улікам аўто, тэлеметрыі і deep links.

API і інтэграцыя

Карыстайся нашым наборам API, каб інтэграваць EV-маршрутызацыю, тэлеметрыю і deep linking у сваю платформу.

Planning API

v2, рэкамендуем

v1, legacy

Маршрутызацыя з улікам аўто і поўным наборам магчымасцей EV-планавання

Наш Planning API дае дасканалае планаванне маршрутаў, якое развіваецца разам з пастаяннымі паляпшэннямі ABRP: мадэлі спажывання энергіі, аптымізацыя прыпынкаў, інтэграцыя трафіку ў рэальным часе і планаванне з улікам надворʼя.

API выкарыстоўвае архітэктуру REST з вывадам JSON і падтрымлівае як legacy (v1), так і сучасныя (v2) эндпоінты. Кошт наладкі і цана за план залежаць ад тваіх патрэб інтэграцыі і абʼёму выкарыстання.

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

Telemetry API

Даныя аўто ў рэальным часе для жывога адсочвання і мадэлявання машын

Telemetry API дае перадачу даных аўто ў рэальным часе для жывога адсочвання паездак, аналізу спажывання і пастаяннага паляпшэння нашых мадэляў машын. Гэта дапамагае нам удакладняць прагнозы энергіі і дакладнасць маршрутаў.

Бясплатныя ключы API даступныя для інтэграцыі. Для адпраўкі даных патрэбныя карыстальніцкія токены, якія можна атрымаць праз наш паток OAuth2 (рэкамендуем) або ўручную для тэставання і распрацоўкі.

Дакументацыя Telemetry Кіруй сваімі telemetry API-ключамі

OAuth2 API

Бяспечная аўтэнтыфікацыя і аўтарызацыя карыстальнікаў

OAuth2 дае бяспечны і зручны спосаб ідэнтыфікаваць і аўтэнтыфікаваць карыстальнікаў з Iternio. Каб наладзіць OAuth2, табе спатрэбіцца 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>

Атрыманне токена

Як толькі атрымаеш код аўтарызацыі, забяры токен, які можна захаваць і паўторна выкарыстоўваць пры неабходнасці.

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 для загадзя наладжанага планавання маршруту

Стварай уласныя URL, якія адкрываюць ABRP з загадзя наладжанымі маршрутамі, выбарам аўто і параметрамі планавання. Ідэальна для ўбудавання ў дадаткі, сайты або навігацыйныя сістэмы без поўнай інтэграцыі API.

Deep links падтрымліваюць шырокі набор параметраў URL, у тым ліку каардынаты адпраўлення і прызначэння, прыпынкі, мадэлі аўто, узровень зараду і налады карыстальніка. Базавы URL: https://abetterrouteplanner.com

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