Dikwalo tsa API
Kopanya bokgoni jwa ABRP jo bo maatla jwa go rulaganya le go tsamaisa EV mo sethaleng sa gago. Setlhopha sa rona se se feletseng sa API se go letla go kopanya ka bonolo go rulaganya tsela go go itseng koloi, telemetry, le deep linking.
Di-API le go Kopanngwa
Fitlhelela setlhopha sa rona sa di-API go kopanya go tsamaisa EV, telemetry, le deep linking mo sethaleng sa gago.
Planning API
Go rulaganya tsela go go itseng koloi ka bokgoni jo bo feletseng jwa go rulaganya EV
Planning API ya rona e tlamela ka go rulaganya tsela mo go boitseanape go go golang le ABRP. Dikarolo di akaretsa go etleetsa tiriso ya maatla, go tokafatsa go tšhaja, go kopanngwa ga sebogo ka nako ya nnete, le go rulaganya go go itseng bosa.
API e dirisa moago wa REST ka tlhagiso ya JSON mme e tshegetsa di-endpoint tsa legacy (v1) le tsa segompieno (v2). Ditshenyegelo tsa go baakanya le tlhotlhwa ya thulaganyo nngwe le nngwe di farologana go ya ka ditlhokego tsa gago tsa go kopanya le bontsi jwa tiriso.
Telemetry API
Data ya koloi ya nako ya nnete bakeng sa go latedisa loeto lo lo tshelang le go dira dimmotlolo tsa dikoloi
Telemetry API e kgontsha go romela data ya koloi ka nako ya nnete bakeng sa go latedisa loeto lo lo tshelang, go sekaseka tiriso, le go tokafatsa ka go tswelela dimmotlolo tsa rona tsa dikoloi. Seno se re thusa go tokafatsa diponelopele tsa maatla le go nepagala ga tsela.
Di-API key tsa mahala di a bonwa bakeng sa go kopanya. Di-token tsa modirisi di a tlhokega bakeng sa go romela data mme di ka bonwa ka tsamaiso ya OAuth2 (e e kgothaletswang) kgotsa ka go bona token ka diatla bakeng sa diteko le tlhabololo.
OAuth2 API
Netefatso ya modirisi le tumelelo tse di sireletsegileng
OAuth2 e tlamela ka tsela e e sireletsegileng le e e bonolo ya go supa le go netefatsa badirisi ka Iternio. Go baakanya OAuth2, o tla tlhoka selotlolo sa API mme o tshwanetse go re fa redirect URL le leina la kopo.
Tsamaiso ya Tumelelo
Mogala wa ntlha o busa tsebe ya HTML e mo go yona badirisi ba ka tsenang le go amogela porogeramo ya gago. Fa e bulwa mo sebading se se tlwaelegileng sa modirisi, go tsena ga bone go ka bolokwa go tlhofofatsa thulaganyo.
https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>get_telemetry: Bona telemetry ya bofelo ya modirisiset_telemetry: Romela dintšhwafatso tsa telemetry mo koloingget_plan: Bona thulaganyo ya bosheng ka sebopego se se khutshwafaditsweng (ikgolaganye le rona go bona dintlha)vehicle_history: Bona maeto a kgale le ditirwana tsa go tšhaja (ikgolaganye le rona go bona dintlha)
https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>Go Bona Token
Fa o sena go bona khoutu ya tumelelo, bona token e e ka bolokwang le go dirisiwa gape fa go tlhokega.
https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>{
"access_token": "<the created token>",
"token_type": "bearer",
"state": "<your supplied state>"
}Tshedimosetso ya Modirisi
Fa o sena go bona token, dirisa endpoint ya "me" go bona tshedimosetso ya modirisi:
https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>{
"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
Go kopanngwa go go theilweng mo URL bakeng sa go rulaganya tsela go go rulagantsweng pele
Dira di-URL tse di kgethegileng tse di simololang ABRP ka ditsela tse di rulagantsweng pele, ditlhopho tsa dikoloi, le diparametara tsa go rulaganya. Di siametse go tsenngwa mo di-app, mo diweposaeteng, kgotsa mo ditsamaisong tsa go tsamaya kwantle ga go kopanngwa ga API.
Deep links di tshegetsa mefutafuta ya diparametara tsa URL go akaretsa dipalo tsa tshimologo le boyo, mafelo a tsela, dimmotlolo tsa dikoloi, seemo sa go tšhaja, le ditlhopho tsa modirisi. URL ya motheo: https://abetterrouteplanner.com