Dokumentasi API

Integrasikan kemampuan perutean dan perencanaan EV ABRP yang andal ke dalam platform kamu. Rangkaian API lengkap kami memungkinkan integrasi mulus untuk navigasi berbasis data kendaraan, telemetri, dan deep link.

API & integrasi

Akses rangkaian API kami untuk mengintegrasikan navigasi EV, telemetri, dan deep link ke dalam platform kamu.

Planning API

v2 - Disarankan

v1 - Legacy

Perutean berbasis data kendaraan dengan kemampuan perencanaan EV lengkap

Planning API kami menyediakan perencanaan rute canggih yang berkembang seiring peningkatan ABRP yang berkelanjutan. Fitur-fiturnya mencakup pemodelan konsumsi energi, optimasi pengisian daya, integrasi lalu lintas waktu nyata, dan perencanaan yang memperhitungkan cuaca.

API ini menggunakan arsitektur REST dengan output JSON dan mendukung endpoint legacy (v1) maupun modern (v2). Biaya penyiapan dan harga per rencana bervariasi tergantung kebutuhan integrasi dan volume penggunaan kamu.

Dokumentasi Planning v2 Dokumentasi Planning v1 (Legacy)

Telemetry API

Data kendaraan waktu nyata untuk pelacakan langsung dan pemodelan mobil

Telemetry API memungkinkan pengiriman data kendaraan waktu nyata untuk pelacakan perjalanan langsung, analisis konsumsi, dan peningkatan berkelanjutan model mobil kami. Hal ini membantu kami menyempurnakan prediksi energi dan akurasi perutean.

Kunci API gratis tersedia untuk integrasi. Token pengguna diperlukan untuk pengiriman data dan bisa diperoleh melalui alur OAuth2 kami (disarankan) atau pengambilan token manual untuk pengujian dan pengembangan.

Dokumentasi Telemetry Kelola kunci Telemetry API kamu

OAuth2 API

Autentikasi dan otorisasi pengguna yang aman

OAuth2 menyediakan cara yang aman dan praktis untuk mengidentifikasi dan mengautentikasi pengguna dengan Iternio. Untuk menyiapkan OAuth2, kamu memerlukan kunci API dan harus menyediakan URL pengalihan serta nama aplikasi.

Alur otorisasi

Panggilan pertama mengembalikan halaman HTML tempat pengguna bisa masuk dan menyetujui aplikasi kamu. Jika dibuka di browser bawaan pengguna, sesi masuk mereka bisa disimpan untuk menyederhanakan prosesnya.

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

Scope yang diizinkan:

get_telemetry: Ambil telemetri terbaru pengguna
set_telemetry: Kirim pembaruan telemetri baru ke kendaraan
get_plan: Dapatkan rencana terbaru dalam bentuk ringkas (hubungi kami untuk detail)
vehicle_history: Ambil riwayat perjalanan dan sesi pengisian daya (hubungi kami untuk detail)

Respons pada URI pengalihan kamu:

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

Pengambilan token

Setelah kamu menerima kode otorisasi, ambil token yang bisa disimpan dan digunakan kembali sesuai kebutuhan.

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

Informasi pengguna

Setelah token diperoleh, gunakan endpoint "me" untuk mengambil informasi 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>"
}

Deep Link

Integrasi berbasis URL untuk perencanaan rute yang sudah dikonfigurasi

Buat URL kustom yang membuka ABRP dengan rute, pilihan kendaraan, dan parameter perencanaan yang sudah dikonfigurasi. Sangat cocok untuk disematkan dalam aplikasi, situs web, atau sistem navigasi tanpa integrasi API.

Deep link mendukung berbagai parameter URL termasuk koordinat asal/tujuan, titik perhentian, model mobil, status pengisian daya, dan preferensi pengguna. URL dasar: https://abetterrouteplanner.com

Dokumentasi deep link