API Referansı Genel Bakış
GraphQL, API’ler için bir sorgu dilidir. Çok sayıda sabit REST uç noktasıyla uğraşmak yerine, ihtiyacınız olan veriyi tek bir çağrıda tam olarak istemenizi sağlar.
API, GraphQL üzerine kurulmuştur. Araçlar, istasyonlar, rotalar ve navigasyon oturumları gibi her kaynağa tek bir GraphQL API üzerinden erişilebilir. Her birine sorgu (query), mutasyon (mutation) veya abonelik (subscription) olarak erişebilirsiniz.
GraphQL’e yeniyseniz, resmi GraphQL belgeleri başlamak için iyi bir yerdir.
GraphQL uç noktaları
Sorgulara, mutasyonlara ve aboneliklere aşağıdaki uç noktalardan erişilebilir. Bir örnek için ilk isteğinizi gönderin bölümüne bakın.
Sorgular ve mutasyonlar için şunu kullanın:
Abonelikler için şunu kullanın:
Kaynaklar
API’yi kaynağa göre keşfedin. Aşağıdaki her bölüm, ilgili sorgulara, mutasyonlara ve aboneliklere bağlantı verir.
| Kaynak | Açıklama |
|---|---|
| Araç | EV özelliklerini, tüketim modellerini ve premium fiyatlandırma verilerini sorgulayın. |
| Bağlı araç | Bir aracı bir bağlantı sağlayıcısına bağlayın ve canlı verilerini alın. |
| İstasyon | Tekil şarj istasyonlarını, yakındaki istasyonları ve olanakları sorgulayın. |
| İstasyon incelemesi | Bir şarj istasyonu için kullanıcı incelemelerini okuyun, ekleyin ve kaldırın. |
| İstasyon tarifesi | Bir istasyonda şarj maliyetini sorgulayın. |
| İstasyon operatörü | Bir istasyonun şarj noktası operatörü hakkındaki ayrıntıları sorgulayın. |
| Tiles | İstasyon verilerine, haritada görüntülemek üzere vektör veya JSON harita karoları olarak erişin. |
| Rota | Şarj durakları, enerji tüketimi ve sürüş süresiyle bir EV rotası hesaplayın. |
| Kamyon rotası | Araç ağırlığını ve boyutlarını dikkate alan bir e-kamyon rotası hesaplayın. |
| Navigasyon | Bir aracın rota üzerindeki ilerleyişini takip edin ve gerçek zamanlı güncellemeler alın. |
| Emisyonlar | Bir rotayı izleyerek tasarruf edilen emisyonları hesaplayın. |
| İzoline | Bir aracın, şarj durumuna göre bir noktadan ulaşabileceği alanı görselleştirin. |
Kimlik doğrulama
Her istek, x-client-id ve x-app-id başlıklarıyla doğrulanır. Bunları nasıl edineceğinizi ve göndereceğinizi yetkilendirme bölümünde bulabilirsiniz.
Sayfalandırma
Liste sorguları ya size ve page argümanlarını ya da imleç tabanlı sayfalandırma için first ve after argümanlarını kullanır. Ayrıntılar için sayfalandırma bölümüne bakın.
Hız sınırlaması
İstekler hız sınırlamasına tabidir.
Yaşam döngüsü
Chargetrip, sürümlendirilmiş yayınlar yerine tek ve sürekli gelişen bir GraphQL API kullanır. Bozucu ve bozucu olmayan değişiklikleri nasıl ele aldığımızı yaşam döngüsü bölümünde bulabilirsiniz.
Bu içerik yardımcı oldu mu?