Integracija TollCalc v lastne aplikacije

TollCalc lahko integrirate v lastno programsko opremo ali AI delovne tokove na tri načine:

REST-API

Celotno dokumentacijo API (OpenAPI 3.0) najdete na:

tollcalc.eu/en/api.html

Hitri začetek

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

Parametri

Avtentikacija

API žetone dobite po registraciji na app.tollcalc.eu. Brez žetona je možnih 10 brezplačnih zahtevkov na sejo.

MCP – Integracija v AI asistenta

TollCalc podpira Model Context Protocol (MCP) in se lahko neposredno integrira v AI orodja, kot so Claude Desktop, Cursor ali drugi MCP-združljivi asistenti.

Končna točka

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

Razpoložljiva orodja

Konfiguracija v Claude Desktop

V konfiguracijo Claude Desktop (claude_desktop_config.json) dodajte:

Možnost A – OAuth (priporočeno): navedite samo URL, žeton ni potreben.

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

Možnost B – API ključ (za avtomatizacijo): žeton shranite ročno, npr. za integracije med strežniki.

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

Brez konfiguracije je na voljo 10 brezplačnih zahtevkov na MCP sejo (= na pogovor) – račun ni potreben. Po 10 zahtevkih Claude Desktop samodejno odpre prijavo v brskalniku (OAuth 2.0). Po prijavi velja naročena kvota. API žetone za možnost B dobite na app.tollcalc.eu.

Primer klica prek MCP

Po nastavitvi lahko asistenta vprašate neposredno:

„Koliko stane cestnina za 40-tonski tovornjak iz Münchna na Dunaj?"

Asistent pokliče orodje calculate_toll in vrne strukturiran odgovor.

Stopnje podrobnosti

Orodje calculate_toll podpira tri stopnje podrobnosti prek parametra detail:

Polja odgovora

Vse stopnje podrobnosti vsebujejo naslednja polja:

S detail=detailed countries dodatno vsebuje segments (segmente z road, type, km, toll_eur). S detail=full pridejo koordinate, source_url, matched_geofence in geometrija.

Server Card

Opis MCP (Server Card) je na voljo na:

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

Paket Python tollcalc

Paket Python tollcalc obdaja REST-API in omogoča uporabo iz Python skript ali Jupyter Notebookov.

Namestitev

pip install tollcalc

Uporaba

from tollcalc import TollCalc

client = TollCalc(api_key="VAŠ_API_TOKEN")

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

print(f"Skupna cestnina: {result.total_toll_eur:.2f} EUR")
print(f"Razdalja:        {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} cestninskih km)")

Koordinate kot vhod

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

Dokumentacija paketa

Celotno dokumentacijo in druge primere najdete na PyPI: pypi.org/project/tollcalc

Cene in kvote

Vse tarife in aktualne cene: tollcalc.eu/de/#pricing

Za vprašanja o integraciji se obrnite na support@tollcalc.eu.