RangeHop APIEnerji ve şarj hesabı, konum almadan.
Uygulamanın, Android Auto'nun ve web planlayıcının kullandığı hesap motoru, sunucudan sunucuya bir API olarak. İstek kişisel veri ve konum taşımaz; yanıt RangeHop modelinin hesabıdır.
Sürüm 1 geliştirildi ve testlerden geçti · henüz canlıya alınmadı
Uçlar (sürüm 1)
| Uç | Girdi | Çıktı |
|---|---|---|
GET /v1/araclar | — | Katalogdaki araçlar: kimlik, marka, model, ad |
POST /v1/enerji | Araç; sıcaklık, yük, batarya sağlığı, başlangıç yüzdesi; yol bölümleri (tür, km, yükselti farkı, hız), en çok 200 bölüm ve 3.000 km | Toplam ve bölüm bölüm kWh, Wh/km, sürüş süresi, geri kazanılan enerji, varış yüzdesi, şarj gerekip gerekmediği |
POST /v1/sarj | Araç; başlangıç ve hedef yüzde, istasyon gücü (3–400 kW), batarya ve dış sıcaklık, batarya sağlığı | Şarj süresi, ortalama güç, şarj sonundaki batarya sıcaklığı |
Kimlik: Authorization: Bearer anahtarı. Sınır: müşteri başına dakikada 60 istek, gövde en çok 64 KB. Başlıca hata kodları: 400, 401, 404, 413, 415, 429.
İlkeler
- Kişisel veri ve konum yok. Her uç kabul ettiği alanları tek tek sayar; listede olmayan alan (koordinat, şasi numarası, plaka, e-posta, ad) 400 ile reddedilir.
- Günlük tutulmaz. İstek gövdesi, IP adresi ve anahtar kaydedilmez; sıklık sınırı IP'ye değil müşteri koduna göre işler. Sunucuda anahtarın kendisi değil yalnız özeti durur.
- Aynı motor. Yanıt, uygulamanın plan motoruyla aynı koddan gelir. Araç katalog değerleri (kapasite, hava direnci) toplu ya da alan alan verilmez.
- Sunucudan sunucuya. Tarayıcıdan çağrılmaz; anahtar tarayıcı koduna konmamalı.
Henüz olmayanlar
- Canlı kurulum. Sürüm 1 yalnız testlerde ve paketleme denemesinde çalıştırıldı; erişim açılmadı.
- Rota ve istasyonlu plan API'si. Konum ve istasyon verisi içerdiği için ayrı aşama: harita verisinin lisansı ve coğrafi veri izni önce netleşecek.
- Fiyat ve sözleşme. Kullanım koşulları ve sorumluluk sınırı hukuki görüşten sonra.
- Doğruluk kıyası. Model, sabit hız ölçümlerine ve OBD kalibrasyonuna dayanır; satış öncesi gerçek yolculuklarla ölçülecek.
Rota sunucusu
Türkiye rotaları kendi sunucumuzda, açık harita verisiyle hesaplanır (yol.rangehop.com). Bugün RangeHop'un kendi uygulamaları ve web planlayıcısı kullanır; üçüncü taraflara hizmet olarak sunulmuyor.
Erken erişim
Filo, kiralama, sigorta ya da kendi uygulaması için enerji ve şarj süresi hesabına ihtiyacı olan ekiplerle ilk müşteri koşullarını birlikte belirlemek istiyoruz.
API için yazınrangehop@cumulusnet.io