Belgekirina API

Kapasîteyên rêvekirin û plansazkirina EV-ya hêzdar a ABRP-ê di platforma te de yek bike. Komxebata meya API-ê ya berfireh yekbûna bêkêmasî ya rêvekirina-agahdar a wesayîtê, telemetrî û taybetmendiyên girêdana kûr dihêle.

API û entegrasyon

Gihîştina pakêta me ya API-yên ku rêvekirina EV-ê, telemetrî, û girêdana kûr di platforma te de bike yek.

Plankirina API

v2 - Pêşniyar kirin

v1 - Mîras

Rêwîtiya haydar a wesayîtê bi kapasîteyên plansaziya EV-ê ya berfireh

API-ya Plansaziya me plansaziya rêgezê ya sofîstîke peyda dike ku bi pêşkeftinên domdar ên ABRP-ê pêşve diçe. Taybetmendî modela xerckirina enerjiyê, xweşbîniya barkirinê, entegrasyona trafîkê ya rast-dem, û plansaziya haya hewayê vedigire.

API mîmariya REST bi derana JSON bikar tîne û hem xalên dawî yên mîras (v1) û hem jî nûjen (v2) piştgirî dike. Mesrefên sazkirinê û bihayê per-planê li gorî hewcedariyên teya entegrasyonê û qebareya karanîna we diguhere.

v2 Belgekirina Plansaziyê v1 Belgekirina Plansaziyê (Mîraset)

Telemetry API

Daneyên wesayîta rast-ê ji bo şopandina zindî û modela gerîdeyê

Telemetry API ji bo şopandina rêwîtiya zindî, analîzkirina serfkirinê, û baştirkirina domdar a modelên gerîdeya me, veguheztina daneya wesayîtê ya rast-dem dihêle. Ev ji me re dibe alîkar ku pêşbîniyên enerjiyê û rastbûna rêvekirinê safî bike.

Bişkojkên API-ya belaş ji bo entegrasyonê hene. Nîşaneyên bikarhêner ji bo radestkirina daneyê hewce ne û dikarî ji hêla herikîna meya OAuth2 (pêşniyar kirin) an jî ji bo ceribandin û pêşkeftinê vegerandina tokenê bi destan werin wergirtin.

Belgekirina Telemetry Bişkojkên API-ya xweya telemetrîyê birêve bibin

OAuth2 API

Nasname û destûrnameya bikarhênerê ewledar bike

OAuth2 rêyek ewledar û hêsan peyda dike ku bikarhêneran bi Iternio re nas bike û rast bike. Ji bo sazkirina OAuth2, tu ê hewceyê mifteyek API-yê bike û pêdivî ye ku URL û navek serîlêdanê beralî bike.

Herikîna Desthilatdariyê

Banga yekem rûpelek HTML vedigere ku bikarhêner dikarî têkevinê û serlêdana te bipejirînin. Ger di geroka xwerû ya bikarhêner de were vekirin, dibe ku têketina wan were cache kirin da ku pêvajoyê hêsan bike.

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

Qadên destûr:

get_telemetry: Telemetrîya herî dawî ya bikarhêner bistînin
set_telemetry: Nûvekirinên telemetryê yên nû li wesayîtê bixin
get_plan: Plana herî paşîn bi forma hevgirtî bistînin (ji bo hûrguliyan bi me re têkilî daynin)
vehicle_history: Dûreyên dîrokî û danişînên barkirinê bistînin (ji bo hûrguliyan bi me re têkilî daynin)

Bersiv li URI-ya teya beralîkirinê:

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

Wergirtina tokenê

Gava ku tu kodek destûrnameyê werdigirin, tokena ku li gorî hewcedariyê dikare were hilanîn û ji nû ve were bikar anîn bistînin.

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

Forma bersivê:

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

Agahiyên Bikarhêner

Piştî wergirtina tokenê, xala dawî ya "me" bikar bînin da ku agahdariya bikarhêner bistînin:

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

Forma bersivê:

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

Girêdanên Kûr

Yekbûna-based URL-ê ji bo plansazkirina rêça pêş-sazkirî

URL-yên xwerû yên ku ABRP-ê bi rêyên pêş-sazkirî, vebijarkên wesayît û pîvanên plansaziyê dest pê dikin biafirînin. Ji bo bicîkirina di serîlêdan, malper, an pergalên navîgasyonê de bê entegrasyona API-ê bêkêmasî ye.

Zencîreyên kûr gelek pîvanên URL-ê piştgirî dikin, di nav de koordînatên eslê/mebestê, xalên rê, modelên gerîdeyê, rewşa barkirinê, û vebijarkên bikarhêner. URL-ya bingehîn: https://abetterrouteplanner.com

Belgekirina Girêdanên Kûr