Yonga.io
İletişim
FİLO & MOBİLİTE GELİŞTİRİCİLERİREST API + MCP

Türkiye'nin şarj verisi,
filo yazılımınızın içine

186 ağı tek tek entegre etmeyin. Standart bir JSON şeması, koordinat bazlı yarıçap araması, tam idari coğrafya ve altı MCP aracı — sürücü uygulamanız, TMS'iniz veya dispatcher panelinizin arkasına takın.

API Erişimi İsteEntegrasyon kılavuzu
1
Entegre edilecek API
186
Kapsanan ağ
200 km
Maks. arama yarıçapı
~ charging-stations · yarıçap araması200 OK
# Sürücünün konumuna en yakın DC istasyonlar
curl "https://dash.yonga.io/api/charging-stations\
?latitude=40,7654&longitude=30,4021\
&radius=25&socket_type=DC&power_min=100\
&fields=summary&limit=10" \
  -H "Authorization: Bearer $YONGA_TOKEN"

distance km cinsinden hesaplanmış gelir, sonuçlar en yakından sıralanır. Virgüllü ondalık (40,7654) kabul edilir.

Entegrasyon senaryoları

Uygulamanızın eksik parçası.

GET /charging-stations

Sürücü uygulamasında istasyon arama

Tek uç noktada dört mod: filtreli liste, anahtar kelime araması, koordinat + yarıçap ve operatör bazında toplulaştırma. Soket tipi, konnektör standardı ve kW aralığıyla daraltılır.

radius=0.1 … 200

Rota koridoru sorgulama

Rotanız üzerindeki noktalar için ardışık yarıçap sorguları çalıştırın, sonuçları birleştirin. Yarıçap 0,1–200 km arasında serbesttir; fields=summary ile yanıt boyutu küçük kalır.

GET /charging-networks?hasPrices=1

Tarife karşılaştırma tablosu

Fiyatı yayınlanmış tüm ağların AC / DC hızlı / DC ultra hızlı tarifelerini çekin. Filo politikanızın maliyet tarafını kendi kurallarınızla kurun.

GET /charging-stations/map?city=istanbul

Harita katmanı

Bir ilin tüm pinlerini sayfalama olmadan tek seferde döndürür. Kümelemeyi istemci tarafında yaparsınız.

GET /cities/{slug}/districts

Coğrafi hiyerarşi ve sınırlar

7 bölge → 81 il → 992 ilçe → ~49.000 mahalle. İl ve ilçe sınırları GeoJSON poligon olarak alınabilir — bölge bazlı filo kuralları ve kapsama haritaları için.

GET /charging-stations/slugs

Kendi katalog sayfalarınız

Yayınlanmış sayfa slug akışını verir; statik site üretimi ve site haritası için tasarlanmıştır. İstasyon detayı id, slug veya EPDK id ile çağrılabilir.

Operasyonel AI ajanları

Dispatcher'ınız sorgu
yazmasın, sorsun

Yonga MCP sunucusunu Claude, Claude Code veya Cursor'a bağlayın. Operasyon ekibiniz doğal dilde sorar; ajan doğru aracı seçer, filtreleri kurar, sonucu özetler.

~ mcp istemci yapılandırmasıHTTP
{
  "mcpServers": {
    "yonga-ev-charging-turkey": {
      "type": "http",
      "url": "https://dash.yonga.io/mcp",
      "headers": { "Authorization": "Bearer ${YONGA_MCP_TOKEN}" }
    }
  }
}
Altı araç
list_charging_stations
filtreli arama ve operatör bazında toplulaştırma
get_station_info
id / slug / EPDK id ile tek istasyon, tam soket listesi
find_nearby_stations
koordinata en yakın istasyonlar
list_networks
ağ operatörlerini listele ve ara
get_network_info
tek ağ: şirket, iletişim, uygulama URL'leri, tarife
geo
Türkiye tüm il → ilçe → mahalle ve poligon bilgisi.
Bir sabah oturumu
Operasyon müdürü

Yarın Ankara–Samsun hattına 6 araç çıkıyor. Çorum ve Amasya'da 100 kW üstü DC nerede var?

list_charging_stations(city="corum", socket_type="DC", power_min=100)
list_charging_stations(city="amasya", socket_type="DC", power_min=100)
Ajan

Çorum'da 9, Amasya'da 4 istasyon. Çorum'daki 9'un 6'sı merkez ilçede. Amasya'daki dördü de Merkez'de — Suluova ve Merzifon'da 100 kW üstü yok.

Operasyon müdürü

Bu iki ilde hangi operatörler baskın? Sözleşme yapacaksak kiminle?

list_charging_stations(city="corum", group_by="network")
list_charging_stations(city="amasya", group_by="network")
Ajan

İki ilde de ilk sırada aynı operatör var; ikisinde birden kapsayan üç ağ mevcut. Tarifelerini de çekeyim mi?

Operasyon müdürü

Çek. Bir de geçen ay bu iki ilde yeni açılan var mı?

get_network_info(slug=…)
GET /events/stations-changelog?days=30

Ajan sayfalamaz, tahmin etmez, slug uydurmaz — araç şemaları bunu engelleyecek şekilde daraltılmıştır.

Entegrasyon kuralları

Sürprizsiz bir API.

Tek yanıt zarfı

Her başarılı yanıt { data, meta }, her hata { data: null, error: { status, name, message, details } }. Liste uç noktalarında meta.pagination, filtreli çağrılarda meta.filters.

Sanctum bearer token

POST /api/login ile token alın, Authorization: Bearer <token> ile kullanın. Token'lar yetenek taşır: stations:read, networks:read, map:read, stats:read. Aynı token REST ve MCP için geçerlidir.

Türkçe normalleştirme

Slug'lar Türkçe katlanmıştır (Eşarj → esarj, Çankaya → cankaya). Arama aksan duyarsız ve çift yönlüdür: kadikoy → Kadıköy ve tersi.

Öngörülebilir varsayılanlar

İstasyon uç noktaları varsayılan olarak faal kayıtları döndürür — halka açık ve özel kullanım istasyonları birlikte; service_type=public|private ile daraltın. Yanıt boyutu için fields=summary / fields=full; sayfa başına maks. 100 satır.

Önbellek ve tazelik

Yanıtlar grup bazında önbelleklenir ve her veri güncellemesinde temizlenir — değişiklik anında görünür.

Hata sözleşmesi

401 kimlik, 403 eksik yetenek, 404 bilinmeyen kayıt, 422 doğrulama, 429 limit (Retry-After başlığıyla), 500 sunucu. Doğrulama hataları alan bazında error.details içinde döner.

Kapsam dışı

Bunları biz sunmuyoruz.

Filo yazılımınızın ihtiyaç duyabileceği bazı şeyler Yonga'nın veri kapsamında değil. Baştan bilmeniz için:

Anlık soket doluluğu ve rezervasyon yok.

Bir soketin şu an dolu mu boş mu olduğunu bildirmiyoruz. Kayıtlı durum alanı (active / inactive / maintenance) vardır, canlı müsaitlik değildir.

Şarj seansı, ödeme ve ciro verisi yok.

Altyapı verisi sunuyoruz, işlem verisi değil. Şarj başlatma ve ödeme için ağ operatörünün kendi roaming/OCPI entegrasyonu gerekir.

Rota motoru ve menzil hesabı yok.

Koordinat + yarıçap sorgusu sağlarız; rota optimizasyonunu kendi motorunuz yapar.

Sürücü/araç bazında harcama raporu yok.

İşlem verisi tutmuyoruz.

Hazır SDK yok.

Standart REST ve JSON — her dilin HTTP istemcisiyle çalışır. OpenAPI 3.1 spesifikasyonu /docs/api.json adresinde, istemci üreticinize verebilirsiniz.

Erişim kademeleri

Limitleri kullanımınıza göre seçin.

Saatlik değer kotanızı, dakikalık değer ani yük tavanınızı belirler. İkisi aynı anda geçerlidir.

KademeSaatlik istekDakikalık istek
Kimliksiz6020
free10020
basic1.00060
pro10.000300
beta20.000500
enterprise100.0002.000

Aynı limitler /api/* ve /mcp için ortaktır. Her yanıtta X-RateLimit-Remaining başlığı bulunur.

Kademe için görüşelim
15 dakikada

Entegrasyonu birlikte planlayalım

Hangi uç noktaların işinize yaradığını konuşalım, sizin senaryonuz için canlı bir yanıt çekelim.

Görüşme AyarlaDiğer çözümlere bak