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. 48)
`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`
`plannedTripStart`	string	Volitelné datum ISO-8601 (`"2026-09-01"`) nebo datum a čas RFC3339 (`"2026-09-01T06:00:00Z"`); vybere pravidla mýta platná v daném okamžiku. Výchozí: nyní

Volitelná hlavička HTTP:

Hlavička	Popis
`X-Subaccount`	Volitelné přiřazení využití, např. pro klientskou firmu nebo oddělení. Počítá se zvlášť pro každý subúčet a zobrazuje ve statistikách využití. Chybí/prázdné → `Default`; max. 64 znaků; povoleno `A-Z a-z 0-9 _ : -`; neplatné → HTTP 400

Využití a kvóta

Po integraci API můžete své využití a kvótu získávat programově – oba endpointy jsou read-only, samy nespotřebovávají kvótu a přijímají stejný bearer token:

Endpoint	Popis
`GET /api/usage`	Úspěšné výpočty za měsíc, rozdělené podle `X-Subaccount`
`GET /api/quota`	Využití, měsíční limit a zbývající kvóta

Volitelné parametry dotazu: year a month (výchozí: aktuální měsíc).

# Využití podle subúčtu
curl https://app.tollcalc.eu/api/usage \
  -H "Authorization: Bearer VAS_API_TOKEN"
# {"year":2026,"month":9,"total":1000,
#  "sub_accounts":[{"key":"kunde_a","count":500},{"key":"Default","count":320}]}

# Zbývající kvóta
curl https://app.tollcalc.eu/api/quota \
  -H "Authorization: Bearer VAS_API_TOKEN"
# {"year":2026,"month":9,"plan":"api","used":123,"limit":5000,"remaining":4877}

Bez hlavičky X-Subaccount u výpočtu se volání přiřadí klíči Default. U neomezených plánů jsou limit a remaining null.

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

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

print(result['total_toll_eur'])

# Využití a kvóta
usage = get_usage(token="VAS_API_TOKEN")
print(usage["total"], "Calls")
quota = get_quota(token="VAS_API_TOKEN")
print(f"{quota['used']} / {quota['limit']} – zbývá: {quota['remaining']}")

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