API-skjöl

Samþættu öfluga EV-leiðar- og skipulagningarmöguleika ABRP á vettvanginn þinn. API-safnið okkar gerir kleift að samþætta ökutækjavitund routing, mælingar og deep links án vandræða.

API og samþætting

Fáðu aðgang að API-safninu okkar til að samþætta EV-routing, mælingar og deep links á vettvanginn þinn.

Planning API

v2 - mælt með

v1 - eldri útgáfa

Ökutækjavitund routing með ítarlegum EV-skipulagningarmöguleikum

Planning API okkar býður upp á ítarlega leiðaráætlun sem þróast með stöðugum umbótum ABRP. Eiginleikarnir fela í sér orkunotkunarlíkön, hleðsluoptímun, samþættingu umferðar í rauntíma og veðurvitund skipulagningu.

API notar REST-arkitektúr með JSON-úttaki og styður bæði eldri (v1) og nýrri (v2) endapunkta. Uppsetningarkostnaður og verð á áætlun fer eftir samþættingarþörfum og notkunarmagni.

v2 Planning-skjöl v1 Planning-skjöl (eldri útgáfa)

Telemetry API

Rauntímagögn ökutækis fyrir beina ferðarmælingu og bílalíkanagerð

Telemetry API gerir kleift að senda rauntímagögn ökutækis fyrir beina ferðarmælingu, notkunargreiningu og stöðugar umbætur á bílalíkönum okkar. Það hjálpar okkur að fínstilla orku-spár og nákvæmni leiða.

Ókeypis API-lyklar eru í boði fyrir samþættingu. Notandamerki þarf til að senda gögn og hægt er að ná þeim annaðhvort í gegnum OAuth2-flæði okkar (mælt með) eða handvirkt til prófs og þróunar.

Telemetry-skjöl Stjórna telemetry API-lyklum þínum

OAuth2 API

Örugg auðkenning og heimild notenda

OAuth2 býður upp á öruggan og þægilegan hátt til að bera kennsl á og auðkenna notendur hjá Iternio. Til að setja upp OAuth2 þarftu API-lykil og redirect-URL ásamt nafni forrits.

Heimildarflæði

Fyrsta kallið skilar HTML-síðu þar sem notendur geta skráð sig inn og samþykkt forritið þitt. Ef opnað er í sjálfgefna vafra notandans getur innskráning verið í skyndiminni til að einfalda ferlið.

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

Leyfð umfang:

get_telemetry: Sækja nýjustu mælingar notanda
set_telemetry: Senda nýjar mælingaruppfærslur í ökutækið
get_plan: Sækja nýjustu áætlun í styttri mynd (hafðu samband fyrir nánar)
vehicle_history: Sækja sögulegar ferðir og hleðslur (hafðu samband fyrir nánar)

Svar á redirect-URI þinni:

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

Söfnun merkis

Þegar þú hefur fengið heimildarkóða sækir þú merkið sem hægt er að vista og endurnýta eftir þörfum.

https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>

Svarsnið:

{
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}

Notendaupplýsingar

Þegar þú hefur merkið notar þú "me"-endapunktinn til að sækja notendaupplýsingar:

https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>

Svarsnið:

{
  "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-samþætting fyrir fyrirfram stillta leiðaráætlun

Búðu til sérsniðnar URL sem ræsa ABRP með fyrirfram stilltum leiðum, vali á ökutæki og skipulagningarbreytum. Fullkomið til að fella inn í forrit, vefi eða leiðsagnarkerfi án API-samþættingar.

Deep links styðja breitt úrval URL-breyta, þar á meðal upphafs-/endirhnit, vegpunkta, bílalíkana, hleðslustöðu og notandastillingar. Grunn-URL: https://abetterrouteplanner.com

Deep links-skjöl