ABRP LogoABRP
    Niedi ABRP

    Dokumentazzjoni API

    Integra l-kapaċitajiet qawwija ta' routing u ppjanar tal-EV ta' ABRP fil-pjattaforma tiegħek. Il-suite komprensiva tal-API tagħna tippermetti integrazzjoni bla xkiel tar-rotot, it-telemetrija u l-karatteristiċi deep linking konxji mill-vettura.

    APIs & Integrazzjoni

    Aċċessa s-suite tagħna ta' APIs biex tintegra r-rotot tal-EV, it-telemetrija, u l-linking profond fil-pjattaforma tiegħek.

    Ippjanar API

    v2 - Rakkomandat
    v1 - Legacy

    Routing konxju mill-vettura b'kapaċitajiet komprensivi ta' ppjanar tal-EV

    L-API tal-Ippjanar tagħna tipprovdi ppjanar tar-rotot sofistikat li jevolvi bit-titjib kontinwu tal-ABRP. Il-karatteristiċi jinkludu mudellar tal-konsum tal-enerġija, ottimizzazzjoni tal-iċċarġjar, integrazzjoni tat-traffiku f'ħin reali, u ppjanar konxju tat-temp.

    L-API tuża arkitettura REST b'output JSON u tappoġġja kemm endpoints legacy (v1) kif ukoll moderni (v2). L-ispejjeż tas-setup u l-ipprezzar għal kull pjan ivarjaw skont il-ħtiġijiet tal-integrazzjoni tiegħek u l-volum tal-użu.

    v2 Dokumentazzjoni tal-Ippjanar Dokumentazzjoni tal-Ippjanar v1 (Legacy)

    API tat-telemetrija

    Dejta tal-vetturi f'ħin reali għal traċċar dirett u mmudellar tal-karozzi

    L-API tat-Telemetrija tippermetti trażmissjoni tad-dejta tal-vetturi f'ħin reali għal traċċar tal-vjaġġi live, analiżi tal-konsum, u titjib kontinwu tal-mudelli tal-karozzi tagħna. Dan jgħinna nirfinaw il-previżjonijiet tal-enerġija u l-eżattezza tar-rotta.

    Ċwievet API b'xejn huma disponibbli għall-integrazzjoni. It-tokens tal-utent huma meħtieġa għas-sottomissjoni tad-dejta u jistgħu jinkisbu jew permezz tal-fluss OAuth2 tagħna (rakkomandat) jew l-irkupru manwali tat-tokens għall-ittestjar u l-iżvilupp.

    Dokumentazzjoni tat-Telemetrija Immaniġġja ċ-ċwievet tal-API tat-telemetrija tiegħek

    OAuth2 API

    Awtentikazzjoni u awtorizzazzjoni sigura tal-utent

    OAuth2 jipprovdi mod sikur u konvenjenti biex jiġu identifikati u awtentikati l-utenti b'Iternio. Biex twaqqaf OAuth2, ikollok bżonn API key u trid tipprovdi URL ta' direzzjoni mill-ġdid u isem tal-applikazzjoni.

    Fluss ta' Awtorizzazzjoni

    L-ewwel sejħa tirritorna paġna HTML fejn l-utenti jistgħu jidħlu u japprovaw l-applikazzjoni tiegħek. Jekk jinfetaħ fil-browser default tal-utent, il-login tagħhom jista' jiġi miżmum fil-cache biex jissimplifika l-proċess.

    https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>
    Ambiti permessi:
    • get_telemetry: Irkupra l-aħħar telemetrija tal-utent
    • set_telemetry: Imbotta aġġornamenti ġodda tat-telemetrija għall-vettura
    • get_plan: Ikseb l-aħħar pjan f'forma mqassra (ikkuntattjana għad-dettalji)
    • vehicle_history: Irkupra drives storiċi u sessjonijiet ta' ċċarġjar (ikkuntattjana għad-dettalji)
    Tweġiba fl-URI ta' redirect tiegħek:
    https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>
    Irkupru tat-Token

    Ladarba tirċievi kodiċi ta' awtorizzazzjoni, irkupra t-token li jista' jinħażen u jerġa' jintuża kif meħtieġ.

    https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>
    Format tar-rispons:
    {
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}
    Informazzjoni għall-Utent

    Wara li tikseb it-token, uża l-endpoint "me" biex tirkupra l-informazzjoni tal-utent:

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

    Integrazzjoni bbażata fuq URL għall-ippjanar tar-rotot ikkonfigurat minn qabel

    Oħloq URLs tad-dwana li jniedu ABRP b'rotot konfigurati minn qabel, selezzjonijiet ta' vetturi, u parametri ta' ppjanar. Perfetta għall-inkorporazzjoni f'apps, websajts jew sistemi ta' navigazzjoni mingħajr integrazzjoni tal-API.

    Links profondi jappoġġjaw firxa wiesgħa ta' parametri URL inklużi koordinati ta' oriġini/destinazzjoni, waypoints, mudelli ta' karozzi, stat ta' ħlas, u preferenzi tal-utent. URL bażi: https://abetterrouteplanner.com

    Deep Links Dokumentazzjoni