API sənədləri

ABRP-nin güclü EV marşrutlaşdırma və planlaşdırma imkanlarını platformana inteqrasiya et. API paketimiz avtomobilə uyğun marşrutlaşdırma, telemetriya və dərin keçidlərin problemsiz birləşməsini təmin edir.

API və inteqrasiya

EV marşrutlaşdırması, telemetriya və dərin keçidləri platformana inteqrasiya etmək üçün API paketimizdən istifadə et.

Planning API

v2 - Tövsiyə olunur

v1 - Köhnə

Geniş EV planlaşdırması ilə avtomobilə uyğun marşrutlaşdırma

Planning API ABRP-nin davamlı təkmilləşmələri ilə inkişaf edən təkmil marşrut planlaşdırması təqdim edir. Enerji sərfiyyatı modelləşdirməsi, şarj optimallaşdırması, real vaxt trafik inteqrasiyası və hava şüurlu planlaşdırma daxildir.

API REST arxitekturası və JSON çıxışı ilə işləyir, həm köhnə (v1), həm də müasir (v2) son nöqtələri dəstəkləyir. Quraşdırma xərcləri və plan başına qiymət inteqrasiya ehtiyaclarına və istifadə həcminə görə dəyişir.

Planning v2 sənədləri Planning v1 sənədləri (Köhnə)

Telemetry API

Canlı izləmə və avtomobil modelləşdirməsi üçün real vaxt avtomobil məlumatı

Telemetry API canlı səfər izləməsi, sərfiyyat analizi və avtomobil modellərimizin davamlı təkmilləşməsi üçün real vaxt məlumat ötürməyə imkan verir. Bu, enerji proqnozlarını və marşrut dəqiqliyini yaxşılaşdırmağa kömək edir.

İnteqrasiya üçün pulsuz API açarları mövcuddur. Məlumat göndərmək üçün istifadəçi tokeni lazımdır, OAuth2 axını (tövsiyə olunur) və ya test və inkişaf üçün əl ilə alınması ilə əldə edilə bilər.

Telemetry sənədləri Telemetry API açarlarını idarə et

OAuth2 API

Təhlükəsiz istifadəçi autentifikasiyası və icazəsi

OAuth2 Iternio ilə istifadəçiləri təhlükəsiz və rahat şəkildə müəyyən etmək və autentifikasiya etmək üçün yoldur. OAuth2 quraşdırmaq üçün API açarı, yönləndirmə URL-i və tətbiq adı lazımdır.

İcazə axını

İlk çağırış istifadəçilərin daxil olub tətbiqini təsdiqlədiyi HTML səhifəsi qaytarır. İstifadəçinin əsas brauzerində açılarsa, daxil olma keşlənə bilər və proses sadələşir.

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

İcazə verilən scope-lar:

get_telemetry: İstifadəçinin son telemetriyasını al
set_telemetry: Avtomobilə yeni telemetriya yeniləmələri göndər
get_plan: Son planı qısa formada al (təfərrüat üçün bizimlə əlaqə saxla)
vehicle_history: Keçmiş sürüş və şarj sessiyalarını al (təfərrüat üçün bizimlə əlaqə saxla)

Yönləndirmə URI-də cavab:

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

Token alınması

İcazə kodunu aldıqdan sonra lazım olduqda saxlanıb yenidən istifadə oluna bilən tokeni götür.

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

Cavab formatı:

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

İstifadəçi məlumatı

Token aldıqdan sonra istifadəçi məlumatını almaq üçün "me" son nöqtəsindən istifadə et:

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

Cavab formatı:

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

Dərin keçidlər

Əvvəlcədən konfiqurasiya edilmiş marşrut planlaşdırması üçün URL əsaslı inteqrasiya

ABRP-ni əvvəlcədən təyin edilmiş marşrutlar, avtomobil seçimi və planlaşdırma parametrləri ilə işə salan fərdi URL-lər yarat. API inteqrasiyası olmadan tətbiq, sayt və ya naviqasiya sistemlərinə daxil etmək üçün idealdır.

Dərin keçidlər başlanğıc/təyinat koordinatları, ara nöqtələr, avtomobil modelləri, şarj səviyyəsi və istifadəçi seçimləri daxil olmaqla geniş URL parametrlərini dəstəkləyir. Əsas URL: https://abetterrouteplanner.com

Dərin keçidlər sənədləri