Yonga Geliştirici Platformu

Türkiye EV Şarj Verisi için API & MCP

Yonga, Türkiye genelindeki ~15.000 şarj istasyonu ve ~181 şarj ağına ait verileri; ayrıca il, ilçe ve mahalle bazında idari coğrafya bilgisini açık bir REST API ile sunar. Aynı veriye yapay zeka ajanları (Cursor, Claude Desktop, Claude Code) üzerinden MCP (Model Context Protocol) ile de erişebilirsiniz.

Neler Sunuyoruz?

Tek bir veri kaynağı, iki erişim yöntemi: klasik REST API ve yapay zeka ajanları için MCP.

Şarj İstasyonları

İl, ilçe, ağ, soket tipi (AC/DC), konnektör (CCS2, Type2, CHAdeMO) ve güç (kW) filtreleriyle istasyon arama. Konuma göre "yakınımdaki" sorguları için koordinat desteği.

Şarj Ağları

Operatör listesi, şirket bilgileri, fiyatlandırma ve bir ağa ait istasyonlar. Ağ adı veya slug ile anahtar kelime araması.

İdari Coğrafya

81 il, ilçeler ve mahalleler; il bazında istatistikler (istasyon/ağ/soket sayıları) ve GeoJSON sınır poligonları.

REST API

Tüm yanıtlar Strapi uyumlu bir zarf yapısı ({ data, meta }) ile döner. Herkese açık okuma uçları kimlik doğrulama gerektirmez.

Metot	Uç Nokta	Açıklama
GET	`/api/charging-stations`	İstasyon listesi, arama ve yakınımdaki sorguları
GET	`/api/charging-stations/{slug}`	Tek istasyon (id, slug veya epdk_id ile)
GET	`/api/charging-networks`	Ağ listesi ve anahtar kelime araması
GET	`/api/charging-networks/{slug}`	Tek ağ detayı (fiyatlandırma, istasyonlar)
GET	`/api/cities`	İl listesi
GET	`/api/cities/{slug}`	İl detayı (`populate=districts,polygon,stats`)
GET	`/api/cities/{slug}/districts`	İle ait ilçeler
POST	`/api/login`	Sanctum token + yetkiler döner

Örnek istek — İstanbul'daki DC istasyonlar:

# Kimlik doğrulama gerektirmez
curl "https://dash.yonga.io/api/charging-stations?city=istanbul&socket_type=DC&limit=10"

Yanıt zarfı:

{
  "data": [ ... ],
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 10,
      "total_pages": 5,
      "total_results": 48
    }
  }
}

İnteraktif API dökümantasyonu için https://dash.yonga.io/docs/api adresini ziyaret edebilirsiniz.

Kimlik Doğrulama (Bearer Token)

Herkese açık REST okuma uçları token gerektirmez. Ancak MCP uç noktası (/mcp) her zaman Sanctum bearer token ister.

Token nasıl alınır?

Bir bearer token (API anahtarı) talep etmek için bizimle e-posta yoluyla iletişime geçin. Hesabınız oluşturulduktan sonra giriş yaparak token'ınızı üretebilirsiniz.

E-posta: hello@yonga.io

Token ile giriş ve kullanım:

# 1) Giriş yap ve token al
curl -X POST "https://dash.yonga.io/api/login" \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"***","device_name":"my-app"}'

# 2) Token'ı isteklerde kullan
curl "https://dash.yonga.io/api/me" \
  -H "Authorization: Bearer 1|abc123..."

MCP (Model Context Protocol)

MCP, yapay zeka ajanlarının (Cursor, Claude Desktop, Claude Code) Yonga verisine doğrudan araç (tool) çağrısıyla erişmesini sağlar. Sohbet içinde Türkçe veya İngilizce soru sorun; ajan uygun aracı otomatik çağırır. Tek sunucu, 9 araç sunar.

EV / Ağ Araçları

list_charging_stations get_station_info list_networks get_network_info find_nearby_stations

Coğrafya Araçları

list_cities get_city list_districts list_mahalles

MCP uç noktası:

POST https://dash.yonga.io/mcp — Yetkilendirme: Authorization: Bearer {token}

MCP Nasıl Kullanılır?

Üç adımda yapay zeka ajanınızı Yonga'ya bağlayın.

Token alın

hello@yonga.io adresine e-posta göndererek bir bearer token talep edin. Token'ınızı ortam değişkeni olarak saklayın.

İstemciyi yapılandırın

Cursor, Claude Desktop veya Claude Code yapılandırma dosyasına Yonga MCP sunucusunu ekleyin (yanda örnek). Token'ı header'a yazın.

Sorgulamaya başlayın

İstemciyi yeniden başlatın ve sohbette doğal dille sorun. Ajan, gerekli Yonga aracını otomatik çağırarak güncel veriyi getirir.

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "yonga-ev-charging-turkey": {
      "url": "https://dash.yonga.io/mcp",
      "headers": {
        "Authorization": "Bearer ${env:YONGA_MCP_TOKEN}"
      }
    }
  }
}

Claude Code — .mcp.json

{
  "mcpServers": {
    "yonga-ev-charging-turkey": {
      "type": "http",
      "url": "https://dash.yonga.io/mcp",
      "headers": {
        "Authorization": "Bearer ${YONGA_MCP_TOKEN}"
      }
    }
  }
}

Örnek sorular (Türkçe):

# Ajan uygun MCP aracını otomatik seçer
"İstanbul'da DC şarj istasyonlarını listele."
"Ankara için istatistikleri getir (get_city, populate=stats)."
"41.01, 28.98 koordinatı civarındaki istasyonları bul."
"ZES ağının İzmir'deki istasyonlarını göster."

Başlamaya hazır mısınız?

API ve MCP erişimi için bir bearer token talep edin. Tüm isteklerinizde memnuniyetle yardımcı oluruz.

hello@yonga.io