ABRP LogoABRP
    Lantschar ABRP

    Documentaziun API

    Integrescha las pussantas funcziunalitads da routing e planisaziun EV da ABRP en tia plattafurma. Nossa suite cumpletta da APIs permetta in'integraziun senza frictiun da routing che resguarda il vehichel, da telemetria e da deep links.

    APIs ed integraziun

    Acceda a nossa suite da APIs per integrar routing EV, telemetria e deep links en tia plattafurma.

    Planning API

    v2 - Recumandà
    v1 - Legacy

    Routing che resguarda il vehichel cun funcziunalitads da planisaziun EV cumplettas

    Nossa Planning API porscha ina planisaziun da via sofisticada che sa sviluppa cun ils megliuraments cuntinuants da ABRP. Las funcziuns cuntegnan il modellar dal consum d'energia, l'optimaziun da las chargiadas, l'integraziun dal traffic en temp real ed ina planisaziun che resguarda l'aura.

    L'API utilisescha in'architectura REST cun output JSON e sustegna kels endpoints legacy (v1) sco era moderns (v2). Ils custs da setup ed ils pretschs per plan varian tenor tias basegns d'integraziun ed il volumen d'utilisaziun.

    Documentaziun Planning v2 Documentaziun Planning v1 (Legacy)

    Telemetry API

    Datas dal vehichel en temp real per il fastizar en directa ed il modellar

    La Telemetry API permetta la transmissiun da datas dal vehichel en temp real per fastizar viadis en directa, analisar il consum e meglierar cuntinuadamain noss models. Quai ans gida da rafinar las previsiuns d'energia e la precisiun dal routing.

    Pèls API gratuits èn disponibels per l'integraziun. Pèr trametter datas dovri tokens d'utilisader, ch'ins po obtegnair u tras noss flux OAuth2 (recumandà) u tras la dumonda manuala da tokens per test e svilup.

    Documentaziun Telemetry Administrar tes pèls API da telemetria

    OAuth2 API

    Autentificaziun ed autorisaziun segira dals utilisaders

    OAuth2 porscha ina moda segira e cumadaivla per identifitgar ed autentifitgar utilisaders cun Iternio. Per configurar OAuth2 dovri in pèl API e stos inditgar in URL da renviament ed in num d'applicaziun.

    Flux d'autorisaziun

    L'emprima clamada renda ina pagina HTML nua che ils utilisaders pon s'annunziar ed approvar tia applicaziun. Sch'ella vegn averta en il browser standard da l'utilisader, po ses annunzia vegnir memorisada en cache per simplifitgar il process.

    https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>
    Scopes permess:
    • get_telemetry: Retrar l'ultima telemetria da l'utilisader
    • set_telemetry: Trametter novas actualisaziuns da telemetria al vehichel
    • get_plan: Retrar l'ultim plan en furma cumpacta (contactescha nus per detagls)
    • vehicle_history: Retrar chauffadas e sessiuns da chargiar istoricas (contactescha nus per detagls)
    Resposta sin tes URI da renviament:
    https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>
    Retrar il token

    Cura che ti retschaivas in code d'autorisaziun, retra il token ch'ins po memorisar e reutilisar tenor basegn.

    https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>
    Format da la resposta:
    {
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}
    Infurmaziuns da l'utilisader

    Suenter avair retschet il token, utilisescha l'endpoint "me" per retrar las infurmaziuns da l'utilisader:

    https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>
    Format da la resposta:
    {
  "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

    Integraziun basada sin URL per ina planisaziun da via preconfigurada

    Creescha URLs persunalisads che lantschan ABRP cun vias, tschernidas da vehichels e parameters da planisaziun preconfigurads. Perfetg per integrar en apps, paginas web u sistems da navigaziun senza integraziun API.

    Ils deep links sustegnan ina vasta gamma da parameters URL, tranter auter coordinatas da partenza/destinaziun, puncts da via, models d'auto, stadi da chargia e preferenzas da l'utilisader. URL da basa: https://abetterrouteplanner.com

    Documentaziun deep links