BizKitHub

Omezení rychlosti

Z BizKitHub Docs, znalostní báze platformy

Politiky spravedlivého používání zajišťují optimální výkon pro všechny uživatele. Zjistěte, jak omezení rychlosti fungují a implementujte jejich hladké zpracování ve svých aplikacích.

Přehled

  • Posuvné okno — Omezení rychlosti používá algoritmus posuvného okna pro plynulé a předvídatelné zpožďování bez náhlých resetů.
  • Omezení výbuchu — Řešte špičky v provozu s omezeními výbuchu, která dovolují krátkodobé používání nad vaši základní rychlost.
  • Na základě API klíče — Omezení se používají na základě API klíče, což vám umožňuje rozložit zátěž napříč více klíči, pokud je to potřeba.

Omezení rychlosti podle plánu

Vyberte plán, který odpovídá potřebám vaší aplikace. Kdykoliv se můžete upgradem přizpůsobit, jak vaše používání roste.

PlánPožadavkyObdobíLimit výbuchuFunkce
Zdarma1,000za hodinu50Základní přístup k API, podpora komunity, standardní koncové body
Začátečník10,000za hodinu200Prioritní přístup k API, e-mailová podpora, všechny koncové body
Profesional100,000za hodinu1,000Vyhrazený fond, telefonická podpora, vlastní webhooks
PodnikovýCustomvyjednatelnéNeomezenýVyhrazená infrastruktura, SLA záruka, vlastní limity

Hlavičky omezení rychlosti

Každá odpověď API obsahuje hlavičky, které vám pomohou sledovat a spravovat vaše používání v reálném čase.

HlavičkaPopisPříklad
X-RateLimit-LimitMaximální počet povolených požadavků v aktuálním časovém okně1000
X-RateLimit-RemainingZbývající požadavky v aktuálním časovém okně999
X-RateLimit-ResetUnix časové razítko, kdy se okno omezení rychlosti resetuje1640995200
Retry-AfterSekundy, které je třeba počkat před opětovným pokusem (pouze u odpovědí 429)3600

Zpracování omezení rychlosti

429 Příliš mnoho požadavků

Když překročíte své omezení rychlosti, API vrátí stavový kód 429. Implementujte logiku opětovného pokusu s exponenciálním zpožděním pro hladké zpracování.

Chybová odpověď

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1640995200
Retry-After: 3600
{ "error": { "code": "RATE_LIMIT_EXCEEDED", "message": "Too many requests", "retry_after": 3600 } }

Příklad logiky opětovného pokusu

async function fetchWithRetry(url, options, retries = 3) {
for (let i = 0; i <= retries; i++) {
const res = await fetch(url, options);
if (res.status === 429) { const wait = res.headers.get('Retry-After'); const delay = wait ? parseInt(wait) * 1000 : Math.pow(2, i) * 1000;
if (i < retries) { await new Promise(r => setTimeout(r, delay)); continue; } } return res; } }

Nejlepší praktiky

  • Sledujte hlavičky omezení rychlosti — Sledovat X-RateLimit-Remaining v každé odpovědi, abyste proaktivně spravovali své používání před dosažením limitů.
  • Implementujte exponenciální zpoždění — Když je omezeno, čekejte progresivně déle mezi opětovnými pokusy, abyste se vyhnuli přetížení API.
  • Mezipaměť odpovědí — Uložte často přistupované údaje lokálně, abyste minimalizovali redundantní API volání a šetřili svůj podíl.
  • Používejte dávkové koncové body — Kombinujte více operací do jednoho požadavku pomocí našich dávkových API, když jsou k dispozici.

Profesionální tip

Používejte webhooks místo polling, když je to možné. To eliminuje zbytečná API volání a poskytuje aktualizace v reálném čase, aniž byste vyčerpali své omezení rychlosti.

Potřebujete vyšší limity?

Podniková zákazníci získají vlastní limity rychlosti přizpůsobené jejich konkrétním požadavkům, vyhrazenou infrastrukturu a prioritní podporu. Podívejte se na dokumentaci API nebo kontaktujte prodej prostřednictvím podpora.

Související

Stránka byla naposledy upravena 24. července 2026.