Limity požadavků

Limity podle tarifu

Tarif Požadavků za hodinu
Free 60
Solo 600
Studio 1 500
Agency 3 000

Okno je pevná hodina podle hodin: počítadlo se resetuje vždy na celou hodinu, ne 60 minut po vašem prvním požadavku. Dávka těsně před celou a další těsně po ní tedy projdou obě.

Počítadlo patří účtu, ne jednotlivému API klíči. Vydáním dalších klíčů si kvótu nezvýšíte — všechny klíče na účtu čerpají ze stejného hodinového rozpočtu.

Odpověď 429

Při překročení limitu vrátí BriefGate HTTP 429:

json
{
  "error": "rate_limited",
  "message": "Rate limit of 60 requests/hour for the free plan reached. Retry after 1847s, or reduce polling frequency — use webhooks instead of polling get_intake_status in a loop.",
  "request_id": "req_abc123"
}

Hlavička Retry-After obsahuje počet sekund, které je potřeba počkat před dalším pokusem. Řiďte se jí, místo abyste se dotazovali v pevném intervalu.

Problém agentní smyčky

Agenti běžící ve smyčce vyčerpají limit 60 req/h na tarifu Free během pár minut, pokud v každé iteraci zavolají get_intake_status. Agent, který se ptá na stav každých 5 sekund, udělá 720 požadavků za hodinu — dvanáctinásobek limitu tarifu Free.

Správné řešení jsou webhooky. Zaregistrujte si endpoint pro události intake.completed a item.submitted. BriefGate ho zavolá, když se něco změní. Vy voláte BriefGate jen tehdy, když na tu změnu potřebujete zareagovat.

S webhooky:

Registrace webhook endpointu:

bash
curl -X POST https://api.briefgate.dev/v1/webhooks \
  -H "Authorization: Bearer bg_live_xxxxx" \
  -d '{"url":"https://yourapp.com/webhooks","events":["intake.completed","item.submitted"]}'

Kompletní návod na nastavení najdete v kapitole Webhooky.

Doporučené intervaly dotazování

Pokud webhooky ve vašem nasazení nejsou k dispozici (třeba když běžíte lokálně bez veřejné URL), dotazujte se nejvýš takto často, ať vám zbyde rezerva i na ostatní volání API:

Tarif Maximální frekvence dotazů
Free Jednou za 5 minut
Solo Jednou za 30 sekund
Studio Jednou za 15 sekund
Agency Jednou za 12 sekund

Pro vystavení lokálního webhook endpointu při vývoji použijte ngrok nebo podobný tunelovací nástroj.

Na co se limit vztahuje

Limity platí na účet, ne na API klíč.