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

Sınırlar: İstek başına en fazla 500 waypoint (origin + via + destination). Çok yoğun koordinat zincirleri (500 m'de 1 noktadan daha sık) sunucu tarafında otomatik olarak seyreltilir ve ORS 3.000 km'den uzun rotaları reddeder – daha uzun turları birkaç isteğe bölün.

İsteğe bağlı HTTP başlığı:

Kimlik Doğrulama

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

Kullanım ve kotayı alma

API entegre edildikten sonra tüketiminizi ve kotanızı programatik olarak alabilirsiniz – her iki uç nokta da read-only'dir, kendisi kota tüketmez ve aynı bearer token'ı kabul eder:

İsteğe bağlı sorgu parametreleri: year ve month (varsayılan: geçerli ay).

# Alt hesaba göre kullanım
curl https://app.tollcalc.eu/api/usage \
  -H "Authorization: Bearer SIZIN_API_TOKEN"
# {"year":2026,"month":9,"total":1000,
#  "sub_accounts":[{"key":"kunde_a","count":500},{"key":"Default","count":320}]}

# Kalan kota
curl https://app.tollcalc.eu/api/quota \
  -H "Authorization: Bearer SIZIN_API_TOKEN"
# {"year":2026,"month":9,"plan":"api","used":123,"limit":5000,"remaining":4877}

Bir hesaplamada X-Subaccount başlığı yoksa çağrılar Default anahtarına atanır. Sınırsız planlarda limit ve remaining null olur.

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 calculate_toll, get_usage, get_quota

result = calculate_toll(
    origin="Munich, Germany",
    destination="Vienna, Austria",
    weight=40,
    axles=5,
    emission_class="euro6",
    co2_class="class_1",
    token="SIZIN_API_TOKEN",
)

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)")

Python'dan kullanım ve kota

from tollcalc import get_usage, get_quota

usage = get_usage(token="SIZIN_API_TOKEN")
print(usage["total"], "Calls")
for s in usage["sub_accounts"]:
    print(f"  {s['key']}: {s['count']}")

quota = get_quota(token="SIZIN_API_TOKEN")
print(f"{quota['used']} / {quota['limit']} – kalan: {quota['remaining']}")

Koordinatlar Girdi Olarak

result = calculate_toll(
    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.