ABRP LogoABRP
    Qalisa i-ABRP

    Amaxwebhu e-API

    Faka amandla e-ABRP okutshintsha indlela nokucwangcisa i-EV kwiqonga lakho. Iseti yethu epheleleyo ye-API ivumela ukudityaniswa okungenamingeni kotshintsho lwendlela olusebenzela isithuthi, i-telemetry, kunye nokunxulumanisa okunzulu.

    Ii-API noDibaniso

    Fumana iseti yethu yee-API ukudibanisa utshintsho lwendlela lwe-EV, i-telemetry, kunye nokunxulumanisa okunzulu kwiqonga lakho.

    I-API yokuCwangcisa

    v2 - Encomekayo
    v1 - Endala

    Utshintsho lwendlela olusebenzela isithuthi kunye nokucwangcisa i-EV okupheleleyo

    I-API yethu yokuCwangcisa inikezela ngokucwangcisa indlela okuphucukileyo okukhula kunye nokuphuculwa okuqhubekayo kwe-ABRP. Iimpawu ziquka ukumodareyitha kokusetyenziswa kwamandla, ukulungelelaniswa kokutshaja, ukudityaniswa kothutho ngexesha lokwenyani, kunye nokucwangcisa okuqwalasela imozulu.

    I-API isebenzisa i-REKHITSHA REST enemveliso ye-JSON kwaye ixhasa zombini ii-endpoint ezindala (v1) nezanamhlanje (v2). Iindleko zokuseta kunye nentengo ngesicwangciso ngasinye ziyahluka ngokusekwe kwiimfuno zakho zokudibanisa kunye nomthamo wokusebenzisa.

    Amaxwebhu okuCwangcisa v2 Amaxwebhu okuCwangcisa v1 (Endala)

    I-API ye-Telemetry

    Idatha yesithuthi yexesha lokwenyani yokulandelela ngoku nokumodareyitha imoto

    I-API ye-Telemetry ivumela ukuthunyelwa kwedatha yesithuthi yexesha lokwenyani ukulandelela uhambo ngoku, uhlalutyo lokusetyenziswa, kunye nokuphuculwa okuqhubekayo kweemodeli zethu zemoto. Oku kusinceda ukulungisa uqikelelo lwamandla kunye nokuchaneka kotshintsho lwendlela.

    Izitshixo ze-API zasimahla ziyafumaneka ukuze kudityaniswe. Iziphawuli zomsebenzisi ziyafuneka ukuthumela idatha kwaye zinokufunyanwa nokuba kungo-OAuth2 wethu (encomekayo) okanye ngokufumana isiphawuli ngesandla ukuvavanya nokuphuhlisa.

    Amaxwebhu e-Telemetry Lawula izitshixo zakho ze-API ye-telemetry

    I-API ye-OAuth2

    Ukuqinisekiswa komsebenzisi okukhuselekileyo nemvume

    I-OAuth2 inikezela ngendlela ekhuselekileyo nelula yokuchonga nokuqinisekisa abasebenzisi e-Iternio. Ukuze usete i-OAuth2, uya kufuna isitshixo se-API kwaye kufuneka unikeze i-URL yokuqondisa kwakhona kunye negama lesicelo.

    Inkqubo yeMvume

    Ikholo lokuqala libuyisela iphepha le-HTML apho abasebenzisi banokungena kwaye bavume isicelo sakho. Ukuba livulwa kwibhrawuza esisiseko yomsebenzisi, ukungena kwabo kunokugcinwa ukwenza inkqubo ibe lula.

    https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>
    Ii-scope ezivunyelweyo:
    • get_telemetry: Fumana i-telemetry yokugqibela yomsebenzisi
    • set_telemetry: Thumela uhlaziyo olutsha lwe-telemetry kwisithuthi
    • get_plan: Fumana isicwangciso sokugqibela ngendlela emfutshane (qhagamshelana nathi ngeenkcukacha)
    • vehicle_history: Fumana ukuqhuba kwexesha elidlulileyo kunye neeseshoni zokutshaja (qhagamshelana nathi ngeenkcukacha)
    Impendulo kwi-URI yakho yokuqondisa kwakhona:
    https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>
    Ukufumana iSiphawuli

    Xa ufumana ikhowudi yemvume, fumana isiphawuli esinokugcinwa kwaye siphinde sisetyenziswe njengoko kufuneka.

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

    Emva kokufumana isiphawuli, sebenzisa i-endpoint ethi "me" ukufumana ulwazi lomsebenzisi:

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

    Amakhonkco anzulu

    Udibaniso olusekwe kwi-URL lokucwangcisa indlela okusele kucwangcisiwe

    Yenza ii-URL zakho eziqalisa i-ABRP ngeendlela ezisele zicwangcisiwe, ukhetho lwesithuthi, kunye neeparamitha zokucwangcisa. Zilungele ukufakwa kwii-app, iiwebhusayithi, okanye iinkqubo zokukhwela ngaphandle kokudibanisa i-API.

    Amakhonkco anzulu axhasa uluhlu olubanzi lweeparamitha ze-URL eziquka ii-coordinate zemvelaphi/endawo ekuyiwa kuyo, iindawo zokuma, iimodeli zemoto, inqanaba lokutshaja, kunye nokuthandwa komsebenzisi. I-URL esisiseko: https://abetterrouteplanner.com

    Amaxwebhu amaKhonkco anzulu