Integrar TollCalc en su aplicación
TollCalc se puede integrar de tres formas en su propio software o flujos de IA:
| Método | Adecuado para |
|---|---|
| API REST | Integración servidor a servidor, backends propios |
| MCP (Model Context Protocol) | Asistentes de IA (Claude, Cursor, GPT, etc.) |
Paquete Python tollcalc |
Scripts, ciencia de datos, notebooks Jupyter |
API REST
La documentación completa de la API (OpenAPI 3.0) se encuentra en:
Inicio rápido
curl -X POST https://app.tollcalc.eu/api/calculate \
-H "Content-Type: application/json" \
-H "Authorization: Bearer TU_TOKEN_API" \
-d '{
"origin": "Munich, Germany",
"destination": "Vienna, Austria",
"vehicle": {
"weight": 40,
"axles": 5,
"emission_class": "euro6",
"co2_class": "class_1"
}
}'
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
origin |
string | Punto de partida: dirección o "lat;lon" |
destination |
string | Punto de destino: dirección o "lat;lon" |
via |
string[] | Paradas intermedias opcionales (máx. 15) |
vehicle.weight |
number | Masa total en toneladas (p. ej. 40) |
vehicle.axles |
integer | Número de ejes: 2, 3, 4 o 5 |
vehicle.emission_class |
string | Norma Euro: euro0–euro6 |
MCP (Model Context Protocol)
Para asistentes de IA como Claude, Cursor o GPT existe un servidor MCP que expone la calculadora como herramienta. Así los asistentes pueden calcular peajes directamente desde el chat – ideal para planificación de rutas, consultas de costes o integración en agentes de logística.
Python
El paquete tollcalc permite calcular peajes directamente desde Python:
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)
Planes de API
El plan API incluye 1 usuario web + 2.000 llamadas API gratuitas al mes. Después: 0,005 € por llamada. Ejemplo: 10.000 llamadas = 65 €/mes. Los tokens de autenticación propios y los límites de llamadas por token están incluidos.