Dokumentasi API

Gabungkan keupayaan penghalaan dan perancangan EV ABRP ke dalam platform anda. Suite API menyeluruh kami menyokong penyatuan navigasi bermaklumat kenderaan, telemetri dan pautan dalam.

API & penyepaduan

Akses suite API kami untuk satukan navigasi EV, telemetri dan pautan dalam ke dalam platform anda.

Planning API

v2 - Disyorkan

v1 - Legasi

Navigasi bermaklumat kenderaan dengan perancangan EV menyeluruh

Planning API kami menawarkan perancangan laluan canggih yang berkembang bersama penambahbaikan berterusan ABRP. Ciri merangkumi pemodelan penggunaan tenaga, pengoptimuman pengecasan, penyepaduan trafik masa nyata dan perancangan peka cuaca.

API ini menggunakan seni bina REST dengan output JSON dan menyokong endpoint legasi (v1) serta moden (v2). Kos penyediaan dan harga bergantung pada keperluan penyepaduan dan volum penggunaan anda.

Dokumentasi Planning v2 Dokumentasi Planning v1 (Legasi)

Telemetry API

Data kenderaan masa nyata untuk penjejakan langsung dan pemodelan kereta

Telemetry API membolehkan penghantaran data kenderaan masa nyata untuk penjejakan perjalanan langsung, analisis penggunaan dan penambahbaikan berterusan model kereta kami. Ini menyempurnakan ramalan tenaga dan ketepatan penghalaan.

Kunci API percuma disediakan untuk penyepaduan. Token pengguna diperlukan untuk penghantaran data dan boleh diperoleh melalui aliran OAuth2 (disyorkan) atau secara manual bagi ujian dan pembangunan.

Dokumentasi Telemetry Urus kunci Telemetry API anda

OAuth2 API

Pengesahan dan kebenaran pengguna yang selamat

OAuth2 menawarkan cara selamat untuk mengenal pasti dan mengesahkan pengguna dengan Iternio. Untuk menyediakan OAuth2, anda perlukan kunci API dan mesti menyediakan URL lencongan serta nama aplikasi.

Aliran kebenaran

Panggilan pertama mengembalikan halaman HTML di mana pengguna boleh log masuk dan meluluskan aplikasi anda. Jika dibuka dalam pelayar lalai pengguna, log masuk mereka boleh disimpan untuk permudahkan proses.

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

Skop dibenarkan:

get_telemetry: Ambil telemetri terkini pengguna
set_telemetry: Hantar kemas kini telemetri baru ke kenderaan
get_plan: Dapatkan pelan terkini dalam bentuk ringkas (hubungi kami untuk butiran)
vehicle_history: Ambil pemanduan dan sesi mengecas lalu (hubungi kami untuk butiran)

Respons pada URI lencongan anda:

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

Perolehan token

Setelah anda menerima kod kebenaran, ambil token yang boleh disimpan dan digunakan semula mengikut keperluan.

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

Format respons:

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

Maklumat pengguna

Setelah token diperoleh, gunakan endpoint "me" untuk mengambil maklumat pengguna:

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

Format respons:

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

Pautan dalam

Penyepaduan berasaskan URL untuk perancangan laluan prakonfigurasi

Cipta URL tersuai yang melancarkan ABRP dengan laluan, pilihan kenderaan dan parameter perancangan sedia. Sesuai untuk disematkan dalam aplikasi, laman atau sistem navigasi tanpa penyepaduan API.

Pautan menyokong pelbagai parameter URL termasuk koordinat asal/destinasi, titik lalu, model kereta, tahap cas dan keutamaan pengguna. URL asas: https://abetterrouteplanner.com

Dokumentasi pautan dalam