API dokümantasyonu

ABRP'nin güçlü EV yönlendirme ve planlama yeteneklerini platformuna entegre et. Kapsamlı API paketimiz, araç-bilinçli yönlendirme, telemetri ve derin bağlantı özelliklerinin sorunsuz entegrasyonunu sağlar.

API'ler ve entegrasyon

EV yönlendirme, telemetri ve derin bağlantıları platformuna entegre etmek için API paketimize eriş.

Planning API

v2 - Önerilen

v1 - Eski

Kapsamlı EV planlamasıyla araç-bilinçli yönlendirme

Planning API'miz, ABRP'nin sürekli gelişimine paralel ilerleyen gelişmiş rota planlaması sunar. Enerji tüketimi modelleme, şarj optimizasyonu, gerçek zamanlı trafik entegrasyonu ve hava-bilinçli planlama gibi özellikleri içerir.

API REST mimarisi ve JSON çıktısı kullanır; hem eski (v1) hem modern (v2) uç noktaları destekler. Kurulum maliyetleri ve plan başına fiyatlandırma, entegrasyon ihtiyaçlarına ve kullanım hacmine göre değişir.

v2 Planning dokümantasyonu v1 Planning dokümantasyonu (Eski)

Telemetry API

Canlı takip ve modelleme için gerçek zamanlı araç verisi

Telemetry API, canlı yolculuk takibi, tüketim analizi ve araç modellerimizin sürekli iyileştirilmesi için gerçek zamanlı araç verisi iletimini sağlar. Enerji tahminlerini ve yönlendirme doğruluğunu geliştirmemize yardımcı olur.

Entegrasyon için ücretsiz API anahtarları sunuyoruz. Veri gönderimi için kullanıcı belirteci gereklidir; önerilen OAuth2 akışımız veya test/geliştirme için manuel belirteç alımı yoluyla elde edilebilir.

Telemetry dokümantasyonu Telemetri API anahtarlarını yönet

OAuth2 API

Güvenli kullanıcı kimlik doğrulama ve yetkilendirme

OAuth2, kullanıcıları Iternio ile güvenli ve kullanışlı biçimde tanımlamanın ve doğrulamanın yoludur. OAuth2 kurulumunda bir API anahtarına ve yönlendirme URL'si ile uygulama adına ihtiyaç duyarsın.

Yetkilendirme akışı

İlk çağrı, kullanıcıların giriş yapıp uygulamanı onayladığı bir HTML sayfası döndürür. Kullanıcının varsayılan tarayıcısında açılırsa oturum önbelleğe alınarak süreç kolaylaştırılabilir.

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

İzin verilen kapsamlar:

get_telemetry: Kullanıcının en son telemetrisini al
set_telemetry: Araca yeni telemetri güncellemeleri gönder
get_plan: En son planı özet biçimde al (ayrıntı için bizimle iletişime geç)
vehicle_history: Geçmiş sürüş ve şarj oturumlarını al (ayrıntı için bizimle iletişime geç)

Yönlendirme URI'ndeki yanıt:

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

Belirteç alma

Yetkilendirme kodunu aldıktan sonra gerektiğinde saklanıp yeniden kullanılabilecek belirteci al.

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

Yanıt biçimi:

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

Kullanıcı bilgisi

Belirteci aldıktan sonra kullanıcı bilgisini almak için "me" uç noktasını kullan:

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

Yanıt biçimi:

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

Derin bağlantılar

Önceden yapılandırılmış rota planlaması için URL tabanlı entegrasyon

ABRP'yi önceden tanımlı rotalar, araç seçimleri ve planlama parametreleriyle başlatan özel URL'ler oluştur. API entegrasyonu olmadan uygulama, web sitesi veya navigasyon sistemlerine gömülemesi için idealdir.

Derin bağlantılar; başlangıç/varış koordinatları, ara noktalar, araç modelleri, şarj durumu ve kullanıcı tercihleri dahil geniş bir parametre yelpazesini destekler. Temel URL: https://abetterrouteplanner.com

Derin bağlantılar dokümantasyonu