VolnéKurty.cz – úvodní stránka

REST API v1 · MCP protokoly 2026-07-28 a 2025-11-25

Spravovat tokeny
Navigace dokumentace

Kvóty

Společná spotřeba REST a MCP

Výchozí beta limit je 200 jednotek denně na účet, nikoli na token nebo kanál. REST a MCP čerpají stejný atomický čítač.

Kolik stojí operace

  • Katalog, seznam areálů, detail a oblíbené: 1 jednotka.
  • Hledání dostupnosti: 1 jednotka za každý požadovaný kalendářní den.
  • /me, get_my_access, MCP inicializace a discovery: 0 denních jednotek.
  • Každá další stránka hledání znovu stojí počet dní původního rozsahu.

Krátkodobý limit

Výchozí tempo je 60 autentizovaných HTTP požadavků za minutu s dávkou 10. Hledání má nejvýše 2 souběžná volání na účet; služba má také globální provozní strop.

429 a opakování

rate_limited znamená krátkodobý nebo souběžný limit, quota_exceeded vyčerpanou denní kvótu. Respektuj hlavičku Retry-After a čas resetsAt; přidej exponenciální prodlevu s náhodnou odchylkou.

Validuj před voláním

Neplatný vstup denní jednotky nečerpá, ale autentizovaný HTTP požadavek se stále počítá do krátkodobého limitu.

Rozsah hledání

Jeden dotaz může zahrnout 1–14 dní, nejvýše 40 skutečně prohledávaných areálů, stránku 1–50 položek a časový rozpočet 10 sekund. Širší výběr vrať jako chybu a filtry zúž.