API skjøl

    Integrera kraftmiklu EV-leiðingar- og planleggingarførleikarnar hjá ABRP í tín pall. Okkara umfatandi API-pakka ger tað møguligt at integrera ómakaleysa akfarstilvitaða leiðslu, telemetri og djúpbindingarfunktiónir.

    API'ir og integratión

    Fá atgongd til okkara API-pakka til at integrera EV-leiðing, telemetri og djúpleinkju í tín pall.

    Planlegging API

    v2 - Viðmælt
    v1 - Eldri

    Akfars-tilvitað leiðing við umfatandi EV planleggingarførleikum

    Okkara Planning API veitir sofistikerad leiðarætlan, sum mennist við áhaldandi ábøtunum hjá ABRP. Funktiónir fevna um orkunýtslumodellering, løðioptimering, ferðsluintegratión í sanntíð og veðurtilvitað planlegging.

    API brúkar ein REST arkitektur við JSON úttøku og stuðlar bæði arva (v1) og nútímans (v2) endapunktum. Uppsetingarkostnaðurin og prísurin fyri hvørja ætlan er ymiskur alt eftir tínum integratiónstørvi og nýtslumongd.

    Fjarmáting API

    Akfarsdátur í sanntíð til beinleiðis sporing og bilmodellering

    Telemetry API ger tað møguligt at senda akfarsdátur í sanntíð til beinleiðis ferðasporing, nýtslugreining og áhaldandi betring av okkara bilmodellum. Hetta hjálpir okkum at fínpussa orkuspáir og leiðsluneyvleika.

    Ókeypis API lyklar eru tøkir til integratión. Brúkaramerki eru kravd til dátuinnsending og kunnu fáast antin gjøgnum okkara OAuth2 streym (mælt) ella manuella token heinta til royndir og menning.

    OAuth2 API

    Trygg brúkaragóðkenning og heimild

    OAuth2 gevur ein tryggan og hóskandi hátt at eyðmerkja og autentisera brúkarar við Iternio. Fyri at seta OAuth2 upp, skalt tú hava ein API lykil og skalt upplýsa eina umleggingar URL og forritanavn.

    Heimildarstreymur

    Fyrsta kallið gevur eina HTML síðu aftur, har brúkarar kunnu logga á og góðkenna tína umsókn. Um tað verður latið upp í forsetta kaganum hjá brúkaranum, kann innritanin hjá teimum verða goymd fyri at einfalda tilgongdina.

    https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>
    Loyvd umfang:
    • get_telemetry: Heinta nýggjastu telemetri hjá brúkaranum
    • set_telemetry: Trýst nýggjar telemetri dagføringar til akfarið
    • get_plan: Fá nýggjastu ætlanina í kondenseraðum formi (set teg í samband við okkum fyri nærri upplýsingar)
    • vehicle_history: Heinta søguligar koyringar og løðitíðir (set teg í samband við okkum fyri at fáa nærri upplýsingar)
    Svar við tínum umleggingar URI:
    https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>
    Token-heinta

    Tá tú hevur fingið eina heimildarkotu, skalt tú heinta tokenið, sum kann goymast og endurnýtast eftir tørvi.

    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>"
    }
    Brúkaraupplýsingar

    Eftir at tú hevur fingið tokenið, brúka "eg" endapunktið til at heinta brúkaraupplý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>"
    }

    Djúpar leinkjur

    URL-baserað integratión til forkonfigureraða leiðarætlan

    Stovna sersniðgivnar slóðir, sum seta ABRP í gongd við forkonfigureraðum leiðum, akfarsvali og planleggingarparametrum. Perfekt til at leggja inn í appir, heimasíður ella navigatiónsskipanir uttan API integratión.

    Djúpar leinkjur stuðla einum breiðum úrvali av URL-parametrum, eitt nú uppruna-/ferðamálskoordinatum, vegpunktum, bilmodellum, løðingarstøðu og brúkaraval. Grund slóð: https://abetterrouteplanner.com