Integrace TollCalc do vaší aplikace

TollCalc lze integrovat třemi způsoby do vlastního softwaru nebo AI pracovních postupů:

Metoda	Vhodné pro
REST API	Integrace server-to-server, vlastní backendy
MCP (Model Context Protocol)	AI asistenty (Claude, Cursor, GPT atd.)
Python balíček `tollcalc`	Skripty, datová věda, Jupyter notebooky

REST API

Kompletní dokumentace API (OpenAPI 3.0) je na:

tollcalc.eu/en/api.html

Rychlý start

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

Parametry

Parametr	Typ	Popis
`origin`	string	Výchozí bod: adresa nebo `"lat;lon"`
`destination`	string	Cílový bod: adresa nebo `"lat;lon"`
`via`	string[]	Volitelné mezizastávky (max. 15)
`vehicle.weight`	number	Celková hmotnost v tunách (např. 40)
`vehicle.axles`	integer	Počet náprav: 2, 3, 4 nebo 5
`vehicle.emission_class`	string	Norma Euro: `euro0`–`euro6`

MCP (Model Context Protocol)

Pro AI asistenty jako Claude, Cursor nebo GPT existuje MCP server, který vystavuje kalkulačku jako nástroj. Asistenti tak mohou počítat mýtné přímo z chatu – ideální pro plánování tras, dotazy na náklady nebo integraci do logistických agentů.

Python

Balíček tollcalc umožňuje vypočítat mýtné přímo z Pythonu:

from tollcalc import calculate_toll

result = calculate_toll(
    origin="Munich, Germany",
    destination="Vienna, Austria",
    weight=40,
    axles=5,
    emission_class="euro6",
)
print(result.total_cost)

API plány

API plán zahrnuje 1 webového uživatele + 2 000 bezplatných API volání měsíčně. Poté: 0,005 € za volání. Příklad: 10 000 volání = 65 €/měsíc. Součástí jsou vlastní autentizační tokeny a limity volání na token.

→ Dokumentace API | → API plán