Integrează TollCalc în aplicația ta
TollCalc poate fi integrat în trei moduri în propriul software sau fluxurile de AI:
| Metodă | Potrivit pentru |
|---|---|
| API REST | Integrare server la server, backend-uri proprii |
| MCP (Model Context Protocol) | Asistenți AI (Claude, Cursor, GPT etc.) |
Pachetul Python tollcalc |
Scripturi, știința datelor, notebook-uri Jupyter |
API REST
Documentația completă a API (OpenAPI 3.0) se găsește pe:
Începere rapidă
curl -X POST https://app.tollcalc.eu/api/calculate \
-H "Content-Type: application/json" \
-H "Authorization: Bearer TOKEN_TAU_API" \
-d '{
"origin": "Munich, Germany",
"destination": "Vienna, Austria",
"vehicle": {
"weight": 40,
"axles": 5,
"emission_class": "euro6",
"co2_class": "class_1"
}
}'
Parametri
| Parametru | Tip | Descriere |
|---|---|---|
origin |
string | Punct de plecare: adresă sau "lat;lon" |
destination |
string | Punct de sosire: adresă sau "lat;lon" |
via |
string[] | Opriri intermediare opționale (max. 48) |
vehicle.weight |
number | Masa totală în tone (ex. 40) |
vehicle.axles |
integer | Număr de axe: 2, 3, 4 sau 5 |
vehicle.emission_class |
string | Norma Euro: euro0–euro6 |
plannedTripStart |
string | Dată ISO-8601 opțională ("2026-09-01") sau dată-oră RFC3339 ("2026-09-01T06:00:00Z"); selectează regulile de taxare valabile la acel moment. Implicit: acum |
Antet HTTP opțional:
| Antet | Descriere |
|---|---|
X-Subaccount |
Atribuire opțională de utilizare, de ex. pentru o firmă client sau un departament. Se contorizează pe subcont și se afișează în statisticile de utilizare. Lipsă/gol → Default; max. 64 caractere; permise A-Z a-z 0-9 _ : -; invalid → HTTP 400 |
Utilizare și cotă
După integrarea API-ului, poți obține consumul și cota în mod programatic – ambele endpoint-uri sunt read-only, nu consumă cotă și acceptă același token bearer:
| Endpoint | Descriere |
|---|---|
GET /api/usage |
Calcule reușite din lună, defalcate pe X-Subaccount |
GET /api/quota |
Consum, limită lunară și cotă rămasă |
Parametri de interogare opționali: year și month (implicit: luna curentă).
# Utilizare pe subcont
curl https://app.tollcalc.eu/api/usage \
-H "Authorization: Bearer TOKEN_TAU_API"
# {"year":2026,"month":9,"total":1000,
# "sub_accounts":[{"key":"kunde_a","count":500},{"key":"Default","count":320}]}
# Cotă rămasă
curl https://app.tollcalc.eu/api/quota \
-H "Authorization: Bearer TOKEN_TAU_API"
# {"year":2026,"month":9,"plan":"api","used":123,"limit":5000,"remaining":4877}
Fără antetul X-Subaccount la un calcul, apelurile sunt atribuite cheii Default. În planurile nelimitate, limit și remaining sunt null.
MCP (Model Context Protocol)
Pentru asistenții AI precum Claude, Cursor sau GPT există un server MCP care expune calculatorul ca unealtă. Astfel, asistenții pot calcula taxele direct din chat – ideal pentru planificarea rutelor, cereri de costuri sau integrarea în agenți logistica.
Python
Pachetul tollcalc permite calcularea taxelor direct din 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'])
# Utilizare și cotă
usage = get_usage(token="TOKEN_TAU_API")
print(usage["total"], "Calls")
quota = get_quota(token="TOKEN_TAU_API")
print(f"{quota['used']} / {quota['limit']} – rămas: {quota['remaining']}")
Planuri API
Planul API include 1 utilizator web + 2.000 de apeluri API gratuite pe lună. După: 0,005 € per apel. Exemplu: 10.000 de apeluri = 65 €/lună. Sunt incluse token-uri de autentificare proprii și limite de apeluri per token.