TollCalc'i kendi uygulamalarınıza entegre edin

TollCalc, kendi yazılımınıza veya yapay zeka iş akışlarınıza üç şekilde entegre edilebilir:

REST-API

Tam API dokümantasyonu (OpenAPI 3.0):

tollcalc.eu/en/api.html

Hızlı Başlangıç

curl -X POST https://app.tollcalc.eu/api/calculate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SIZIN_API_TOKEN" \
  -d '{
    "origin": "Munich, Germany",
    "destination": "Vienna, Austria",
    "vehicle": {
      "weight": 40,
      "axles": 5,
      "emission_class": "euro6",
      "co2_class": "class_1"
    }
  }'

Parametreler

Kimlik Doğrulama

API token'ları app.tollcalc.eu adresinde kayıt sonrası alınır. Token olmadan oturum başına 10 ücretsiz istek mümkündür.

MCP – Yapay Zeka Asistanlarına Entegrasyon

TollCalc, Model Context Protocol'ü (MCP) destekler ve Claude Desktop, Cursor veya diğer MCP uyumlu asistanlar gibi yapay zeka araçlarına doğrudan entegre edilebilir.

Uç Nokta

POST https://app.tollcalc.eu/mcp

Kullanılabilir Araçlar

Claude Desktop'ta Yapılandırma

Claude Desktop yapılandırmanıza (claude_desktop_config.json) şunu ekleyin:

Seçenek A – OAuth (önerilir): Yalnızca URL'yi belirtin, token gerekmez.

{
  "mcpServers": {
    "tollcalc": {
      "url": "https://app.tollcalc.eu/mcp"
    }
  }
}

Seçenek B – API anahtarı (otomasyon için): Token'ı manuel saklayın, örn. sunucudan sunucuya entegrasyonlar için.

{
  "mcpServers": {
    "tollcalc": {
      "url": "https://app.tollcalc.eu/mcp",
      "headers": {
        "Authorization": "Bearer SIZIN_API_TOKEN"
      }
    }
  }
}

Yapılandırma olmadan MCP oturumu başına (= konuşma başına) 10 ücretsiz istek mevcuttur – hesap gerekmez. 10 istekten sonra Claude Desktop otomatik olarak bir tarayıcı girişi (OAuth 2.0) açar. Girişten sonra satın alınan kota geçerlidir. Seçenek B için API token'ları app.tollcalc.eu adresinde alınır.

MCP Üzerinden Örnek Çağrı

Kurulumdan sonra asistana doğrudan soru sorabilirsiniz:

„Münih'ten Viyana'ya bir 40 tonluk için geçiş ücreti ne kadar?"

Asistan calculate_toll aracını çağırır ve yapılandırılmış bir yanıt döndürür.

Detay Seviyeleri

calculate_toll aracı detail parametresi üzerinden üç detay seviyesini destekler:

Yanıt Alanları

Tüm detay seviyeleri şu alanları içerir:

detail=detailed ile countries ayrıca segments (road, type, km, toll_eur içeren kesimler) içerir. detail=full ile koordinatlar, source_url, matched_geofence ve geometri eklenir.

Sunucu Kartı

MCP açıklaması (Sunucu Kartı) şuradan alınabilir:

GET https://app.tollcalc.eu/.well-known/mcp-server

Python Paketi tollcalc

Python paketi tollcalc, REST-API'yi sarmalar ve Python betiklerinden veya Jupyter Notebook'lardan kullanımı sağlar.

Kurulum

pip install tollcalc

Kullanım

from tollcalc import TollCalc

client = TollCalc(api_key="SIZIN_API_TOKEN")

result = client.calculate(
    origin="Munich, Germany",
    destination="Vienna, Austria",
    weight=40,
    axles=5,
    emission_class="euro6",
    co2_class="class_1",
)

print(f"Toplam geçiş ücreti: {result.total_toll_eur:.2f} EUR")
print(f"Mesafe:              {result.total_distance_km:.1f} km")

for country in result.countries:
    print(f"  {country.country_name}: {country.toll_eur:.2f} EUR ({country.toll_km:.0f} ücretli km)")

Koordinatlar Girdi Olarak

result = client.calculate(
    origin="48.1374;11.5755",    # Münih (lat;lon)
    destination="48.2082;16.3738",  # Viyana
    weight=40,
    axles=5,
)

Paket Dokümantasyonu

Tam dokümantasyon ve diğer örnekler PyPI'de: pypi.org/project/tollcalc

Fiyatlar ve Kotalar

Tüm tarifeler ve güncel fiyatlar: tollcalc.eu/de/#pricing

Entegrasyonla ilgili sorularınız için: support@tollcalc.eu.