Интеграция на TollCalc API и MCP

Чрез REST API и MCP (Model Context Protocol) сървъра, изчисляването на пътни такси може да бъде интегрирано директно в собствени системи.

REST API

  • POST /api/calculate – изчисление за маршрут (origin, destination, via, vehicle)
  • GET /api/rules – актуални правила по държави
  • Допълнителен параметър: plannedTripStart (дата или datetime) – използва правилата, валидни към избрания момент
  • Опционален хедър: X-Subaccount (етикет за приписване на използването, напр. фирма клиент; макс. 64 знака, разрешени A-Z a-z 0-9 _ : -; при невалиден → HTTP 400)

MCP сървър

Чрез MCP AI асистентите могат директно да извикват инструмента calculate_toll с данните за превозното средство, началната и крайната точка. Отговорът включва разбивка по държави и info-URL за картата.

Удостоверяване

  • API ключ: заглавка Authorization: Bearer <token>
  • Анонимен достъп: до 10 изчисления месечно
  • Използване: GET /api/usage – успешни изчисления за месеца, разбити по X-Subaccount
  • Оставаща квота: GET /api/quota – използвано, месечен лимит и остатък (незадължителни year/month)
  • Пълна документация: tollcalc.eu/en/api.html

→ Отваряне на API документацията