Integration af TollCalc i dine egne applikationer

TollCalc kan integreres i din egen software eller AI-arbejdsgange på tre måder:

REST-API

Den fulde API-dokumentation (OpenAPI 3.0) finder du på:

tollcalc.eu/en/api.html

Hurtig start

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

Parametre

Grænser: Maks. 500 waypoints pr. anmodning (origin + via + destination). For tætte koordinatkæder (tættere end 1 punkt pr. 500 m) udtyndes automatisk på serveren, og ORS afviser ruter længere end 3.000 km – opdel længere ture i flere anmodninger.

Valgfri HTTP-header:

Autentifikation

API-tokens får du efter registrering på app.tollcalc.eu. Uden token er der 10 gratis forespørgsler pr. måned (pr. IP-adresse).

Hent forbrug og kvote

Når API'et er integreret, kan du hente dit forbrug og din kvote programmatisk – begge endepunkter er read-only, bruger ikke selv kvote og accepterer samme bearer-token:

Valgfrit query-parameter: year og month (standard: aktuel måned).

# Forbrug pr. subkonto
curl https://app.tollcalc.eu/api/usage \
  -H "Authorization: Bearer DIN_API_TOKEN"
# {"year":2026,"month":9,"total":1000,
#  "sub_accounts":[{"key":"kunde_a","count":500},{"key":"Default","count":320}]}

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

Uden X-Subaccount-header på en beregning tilskrives kaldet nøglen Default. Ved ubegrænsede abonnementer er limit og remaining null.

MCP – Integration i AI-assistenter

TollCalc understøtter Model Context Protocol (MCP) og kan integreres direkte i AI-værktøjer som Claude Desktop, Cursor eller andre MCP-kompatible assistenter.

Endpoint

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

Tilgængelige værktøjer

Konfiguration i Claude Desktop

Tilføj følgende til din Claude Desktop-konfiguration (claude_desktop_config.json):

Mulighed A – OAuth (anbefalet): Angiv kun URL'en, ingen token nødvendig.

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

Mulighed B – API-nøgle (til automatisering): Gem token manuelt, fx til server-til-server-integrationer.

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

Uden konfiguration er der 10 gratis forespørgsler pr. MCP-session (= pr. samtale) til rådighed – ingen konto nødvendig. Efter 10 forespørgsler åbner Claude Desktop automatisk et browserlogin (OAuth 2.0). Efter login gælder det købte kvote. API-tokens til mulighed B får du på app.tollcalc.eu.

Eksempelopkald via MCP

Efter opsætningen kan du spørge assistenten direkte:

"Hvad koster vejafgiften for en 40-tonner fra München til Wien?"

Assistenten kalder værktøjet calculate_toll og returnerer et struktureret svar.

Detaljeniveauer

Værktøjet calculate_toll understøtter tre detaljeniveauer via parameteren detail:

Svarfelter

Alle detaljeniveauer indeholder følgende felter:

Med detail=detailed indeholder countries desuden segments (segmenter med road, type, km, toll_eur). Med detail=full kommer koordinater, source_url, matched_geofence og geometri til.

Server Card

MCP-beskrivelsen (Server Card) kan hentes på:

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

Python-pakke tollcalc

Python-pakken tollcalc omslutter REST-API'et og muliggør brug fra Python-scripts eller Jupyter Notebooks.

Installation

pip install tollcalc

Brug

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="DIN_API_TOKEN",
)

print(f"Samlet vejafgift: {result['total_toll_eur']:.2f} EUR")
print(f"Strækning:        {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} afgifts-km)")

Forbrug og kvote fra Python

from tollcalc import get_usage, get_quota

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

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

Koordinater som input

result = calculate_toll(
    origin="48.1374;11.5755",    # München (lat;lon)
    destination="48.2082;16.3738",  # Wien
    weight=40,
    axles=5,
)

Pakkedokumentation

Fuld dokumentation og flere eksempler finder du på PyPI: pypi.org/project/tollcalc

Priser og kvoter

Alle tariffer og aktuelle priser: tollcalc.eu/de/#pricing

For spørgsmål om integration kontakt support@tollcalc.eu.