ABRP LogoABRP
    Qala i-ABRP

    Imibhalo ye-API

    Hlanganisa amandla e-ABRP okuqondisa nokuhlela kwe-EV epulatifomu yakho. I-API suite yethu ephelele ivumela ukuhlanganiswa okungenamthungo kokuqondisa okubona imoto, i-telemetry, kanye nezici ze-deep linking.

    Ama-API & Ukuhlanganisa

    Finyelela i-API suite yethu ukuze uhlanganise ukuqondisa kwe-EV, i-telemetry, kanye ne-deep linking epulatifomu yakho.

    Planning API

    v2 - Enconywayo
    v1 - Endala

    Ukuqondisa okubona imoto okunamakhono okuhlela kwe-EV aphelele

    I-Planning API yethu inikeza ukuhlela indlela okuyingcweti okukhula nokuthuthuka okuqhubekayo kwe-ABRP. Izici zihlanganisa ukwakha imodeli yokusetshenziswa kwamandla, ukuthuthukisa ukushaja, ukuhlanganiswa kothrafikhu wesikhathi sangempela, kanye nokuhlela okubona isimo sezulu.

    I-API isebenzisa i-REST architecture enesokuphuma se-JSON futhi isekela kokubili ama-endpoint amadala (v1) nawesimanje (v2). Izindleko zokusetha nentengo ngehlelo ngalinye ziyahluka ngokuya ngezidingo zakho zokuhlanganisa kanye nevolumu yokusetshenziswa.

    Imibhalo ye-Planning v2 Imibhalo ye-Planning v1 (Endala)

    Telemetry API

    Idatha yemoto yesikhathi sangempela yokulandelela bukhoma nokwakha imodeli yezimoto

    I-Telemetry API ivumela ukudluliswa kwedatha yemoto yesikhathi sangempela ukuze kulandelelwe uhambo bukhoma, kuhlaziywe ukusetshenziswa, futhi kuthuthukiswe njalo amamodeli ezimoto zethu. Lokhu kusisiza sicwenge izibikezelo zamandla nokunemba kokuqondisa.

    Okhiye be-API bamahhala bayatholakala ukuze kuhlanganiswe. Amathokheni omsebenzisi ayadingeka ukuthumela idatha futhi angatholakala nge-OAuth2 flow yethu (enconywayo) noma ngokulanda ithokheni ngesandla ukuze kuhlolwe nokuthuthukiswa.

    Imibhalo ye-Telemetry Phatha okhiye bakho be-API ye-telemetry

    OAuth2 API

    Ukufakazela nokugunyaza umsebenzisi okuphephile

    I-OAuth2 inikeza indlela ephephile nelula yokuhlonza nokufakazela abasebenzisi ne-Iternio. Ukuze usethe i-OAuth2, uzodinga ukhiye we-API futhi kufanele unikeze i-URL yokuqondisa kabusha negama lohlelo lokusebenza.

    Indlela Yokugunyaza

    Ucingo lokuqala lubuyisela ikhasi le-HTML lapho abasebenzisi bengangena bese begunyaza uhlelo lwakho lokusebenza. Uma kuvulwa kusiphequluli esiyisisekelo somsebenzisi, ukungena kwabo kungalondolozwa ukwenza inqubo ibe lula.

    https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>
    Imikhawulo evunyelwe:
    • get_telemetry: Thola i-telemetry yakamuva yomsebenzisi
    • set_telemetry: Thumela izibuyekezo ze-telemetry ezintsha emotweni
    • get_plan: Thola uhlelo lwakamuva ngendlela efingqiwe (xhumana nathi ukuze uthole imininingwane)
    • vehicle_history: Thola ukushayela nezikhathi zokushaja zomlando (xhumana nathi ukuze uthole imininingwane)
    Impendulo ku-URI yakho yokuqondisa kabusha:
    https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>
    Ukulanda Ithokheni

    Lapho usuthola ikhodi yokugunyaza, landa ithokheni elingalondolozwa futhi lisetshenziswe kabusha njengoba kudingeka.

    https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>
    Ifomethi yempendulo:
    {
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}
    Ulwazi Lomsebenzisi

    Ngemva kokuthola ithokheni, sebenzisa i-endpoint engu-"me" ukuze uthole ulwazi lomsebenzisi:

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

    Ukuhlanganisa okusekelwe ku-URL kokuhlela indlela esethwe ngaphambili

    Dala ama-URL ngokwezifiso aqala i-ABRP ngezindlela ezisethwe ngaphambili, izinketho zezimoto, namaphalamitha okuhlela. Akulungele ukufakwa kuma-app, amawebhusayithi, noma izinhlelo zokuqondisa ngaphandle kokuhlanganisa i-API.

    Ama-deep link asekela uhla olubanzi lwamaphalamitha e-URL kuhlanganise nezixhumanisi zemvelaphi/zendawo oya kuyo, ama-waypoint, amamodeli ezimoto, isimo sokushaja, kanye nezintando zomsebenzisi. I-URL eyisisekelo: https://abetterrouteplanner.com

    Imibhalo ye-Deep Links