Intégrer TollCalc dans votre application

TollCalc peut être intégré de trois façons dans votre propre logiciel ou vos flux IA :

Méthode	Adapté à
API REST	Intégration serveur à serveur, backends propres
MCP (Model Context Protocol)	Assistants IA (Claude, Cursor, GPT, etc.)
Paquet Python `tollcalc`	Scripts, science des données, notebooks Jupyter

API REST

La documentation complète de l'API (OpenAPI 3.0) se trouve sur :

tollcalc.eu/en/api.html

Démarrage rapide

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

Paramètres

Paramètre	Type	Description
`origin`	string	Point de départ : adresse ou `"lat;lon"`
`destination`	string	Point d'arrivée : adresse ou `"lat;lon"`
`via`	string[]	Étapes intermédiaires facultatives (max. 48)
`vehicle.weight`	number	Masse totale en tonnes (p. ex. 40)
`vehicle.axles`	integer	Nombre d'essieux : 2, 3, 4 ou 5
`vehicle.emission_class`	string	Norme Euro : `euro0`–`euro6`
`plannedTripStart`	string	Date ISO-8601 facultative (`"2026-09-01"`) ou date-heure RFC3339 (`"2026-09-01T06:00:00Z"`) ; sélectionne les règles de péage valides à ce moment. Par défaut : maintenant

En-tête HTTP facultatif :

En-tête	Description
`X-Subaccount`	Attribution d'usage facultative, p. ex. pour une société cliente ou un service. Comptée par sous-compte et affichée dans vos statistiques d'usage. Absent/vide → `Default` ; max 64 caractères ; autorisés `A-Z a-z 0-9 _ : -` ; invalide → HTTP 400

Utilisation et quota

Une fois l'API intégrée, vous pouvez récupérer votre consommation et votre quota par programmation – les deux endpoints sont read-only, ne consomment pas de quota et acceptent le même token bearer :

Endpoint	Description
`GET /api/usage`	Calculs réussis du mois, répartis par `X-Subaccount`
`GET /api/quota`	Consommation, limite mensuelle et quota restant

Paramètres de requête facultatifs : year et month (par défaut : mois en cours).

# Utilisation par sous-compte
curl https://app.tollcalc.eu/api/usage \
  -H "Authorization: Bearer VOTRE_TOKEN_API"
# {"year":2026,"month":9,"total":1000,
#  "sub_accounts":[{"key":"kunde_a","count":500},{"key":"Default","count":320}]}

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

Sans en-tête X-Subaccount lors d'un calcul, les appels sont attribués à la clé Default. Pour les forfaits illimités, limit et remaining valent null.

MCP (Model Context Protocol)

Pour les assistants IA comme Claude, Cursor ou GPT, il existe un serveur MCP qui expose la calculatrice comme outil. Ainsi, les assistants peuvent calculer les péages directement depuis le chat – idéal pour la planification d'itinéraires, les demandes de coûts ou l'intégration dans des agents logistiques.

Python

Le paquet tollcalc permet de calculer les péages directement depuis Python :

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'])

# Utilisation et quota
usage = get_usage(token="VOTRE_TOKEN_API")
print(usage["total"], "Calls")
quota = get_quota(token="VOTRE_TOKEN_API")
print(f"{quota['used']} / {quota['limit']} – restant: {quota['remaining']}")

Plans API

Le plan API comprend 1 utilisateur web + 2 000 appels API gratuits par mois. Ensuite : 0,005 € par appel. Exemple : 10 000 appels = 65 €/mois. Des jetons d'authentification propres et des limites d'appels par jeton sont inclus.

→ Documentation de l'API | → Plan API