Litokomane tsa API

Kopanya ABRP e matla ea ho tsamaisa EV le bokhoni ba ho rera sethaleng sa hau. Sesebelisoa sa rona se felletseng sa API se thusa ho kopanya ka mokhoa o se nang moeli oa tsela e tsebang koloi, telemetry, le likarolo tse tebileng tsa khokahano.

Li-API & Khokahano

Fumana setsi sa rona sa li-API ho kopanya mekhoa ea EV, telemetry, le khokahanyo e tebileng sethaleng sa hau.

Planning API

v2 - E khothalelitsoe

v1 - Lefa

Tsela e hlokomelang koloi e nang le bokhoni bo felletseng ba ho rera ba EV

Planning API ea rona e fana ka moralo o tsoetseng pele oa litsela o fetohang ka ntlafatso e tsoelang pele ea ABRP. Likarolo li kenyelletsa mohlala oa tšebeliso ea matla, ho ntlafatsa ho tjhaja, ho kopanya sephethephethe ka nako ea nnete, le moralo oa ho hlokomela boemo ba leholimo.

API e sebelisa meralo ea REST e nang le tlhahiso ea JSON mme e ts'ehetsa liphetho tsa lefa (v1) le tsa sejoale-joale (v2). Litšenyehelo tsa ho seta le litheko tsa moralo ka 'ngoe li fapana ho latela litlhoko tsa hau tsa ho kopanya le bongata ba tšebeliso.

v2 Litokomane tsa moralo v1 Litokomane tsa Moralo (Lefa)

Telemetry API

Lintlha tsa koloi tsa nako ea 'nete bakeng sa ho latedisa le ho etsa mohlala oa koloi

Telemetry API e thusa phetisetso ea data ea koloi ka nako ea 'nete bakeng sa ho latedisa leeto le phelang, tlhahlobo ea tšebeliso, le ntlafatso e tsoelang pele ea mefuta ea rona ea likoloi. Sena se re thusa ho ntlafatsa likhakanyo tsa matla le ho nepahala ha litsela.

Linotlolo tsa mahala tsa API li teng bakeng sa ho kopanngoa. Li-tokens tsa basebelisi lia hlokahala bakeng sa tlhahiso ea data 'me li ka fumanoa ka phallo ea rona ea OAuth2 (e khothalelitsoeng) kapa ho khutlisa tokene ka letsoho bakeng sa tlhahlobo le nts'etsopele.

Litokomane tsa Telemetry Laola linotlolo tsa hau tsa telemetry API

OAuth2 API

Sireletsa netefatso le tumello ea mosebelisi

OAuth2 e fana ka mokhoa o sireletsehileng le o bonolo oa ho tseba le ho netefatsa basebelisi ka Iternio. Ho theha OAuth2, o tla hloka senotlolo sa API mme o tlameha ho fana ka URL e lebisang hape le lebitso la sesebelisoa.

Phallo ea tumello

Mohala oa pele o khutlisa leqephe la HTML moo basebelisi ba ka kenang le ho amohela kopo ea hau. Haeba e buletsoe ho sebatli sa kamehla sa mosebelisi, ho kena ha bona ho ka bolokoa ho nolofatsa ts'ebetso.

https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>

Likarolo tse lumelletsoeng:

get_telemetry: Khutlisa telemetry ea morao-rao ea mosebelisi
set_telemetry: Sutumelletsa lintlafatso tse ncha tsa telemetry koloing
get_plan: Fumana moralo oa morao-rao ka mokhoa o khutsufalitsoeng (ikopanye le rona bakeng sa lintlha)
vehicle_history: Fumana li-drive tsa nalane le linako tsa ho tjhaja (ikopanye le rona bakeng sa lintlha tse ling)

Karabo ho URI ea hau e romellang bocha:

https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>

Ho Khutlisa Letšoao

Hang ha o fumana khoutu ea tumello, fumana lets'oao le ka bolokoang le ho sebelisoa hape ha ho hlokahala.

https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>

Sebopeho sa karabo:

{
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}

Lintlha tsa mosebelisi

Kamora ho fumana letshwao, sebelisa "me" qetellong ho fumana lintlha tsa mosebelisi:

https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>

Sebopeho sa karabo:

{
  "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>"
}

Lihokelo tse Tebileng

Khokahano e thehiloeng ho URL bakeng sa moralo oa litsela o lokiselitsoeng esale pele

Theha li-URL tsa tloaelo tse hlahisang ABRP ka litsela tse lokiselitsoeng esale pele, khetho ea likoloi, le maemo a moralo. E nepahetse bakeng sa ho kenella lits'ebetsong, liwebsaete, kapa litsamaiso tsa ho tsamaea ntle le ho kopanya API.

Lihokelo tse tebileng li ts'ehetsa mefuta e mengata e fapaneng ea litlhophiso tsa URL ho kenyelletsa lihokahanyo tsa tšimoloho / sebaka sa ho ea, litsela, mefuta ea likoloi, boemo ba tefiso, le likhetho tsa basebelisi. URL ea motheo: https://abetterrouteplanner.com

Litokomane tsa Lihokelo tse Tebileng