Limity požadavků API

Co limit požadavků omezuje

Limit požadavků hlídá, jak často smí vaše aplikace na API zavolat — tedy počet požadavků, ne počet odeslaných zpráv. Portál na to sám upozorňuje v nastavení:

Nastavením tohoto limitu se omezuje počet požadavků API, nikoli počet odeslaných zpráv. Po dosažení limitu API vrátí kód HTTP 429 Too Many Requests a zprávy nebudou přijaty.

Jeden požadavek přitom může nést i stovky zpráv, takže tenhle limit chrání něco jiného než Limity zpráv API — hlídá tempo volání, ne objem odeslaného.

Kde limit najdu

1. V menu portálu klikněte na Moduly a API
2. V části Moje API a Moduly klikněte na kartu své aplikace
3. Zůstaňte na kartě Nastavení a sjeďte do části Limity API

Dlaždice Limity požadavků API ukazuje nastavené hodnoty ve dvou řádcích — Maximální počet požadavků za minutu a Maximální počet požadavků za sekundu. Dokud nic nastavené není, je tu Nemáte žádná nastavení. a tlačítko Konfigurovat.

Jak limit nastavím

Tlačítko Konfigurovat (nebo Upravit, pokud limit už máte) otevře okno Limity požadavků API se dvěma nezávislými volbami:

Zaškrtnutím volby se odkryje pole Zadejte Počet požadavků. Zapnout můžete jednu z nich, nebo obě zároveň.

Nastavení hlídají dvě pravidla:

• nejmenší přijatelná hodnota je 1 — jinak vás portál upozorní hláškou Minimální hodnota je 1
• pokud zapnete obě volby, limit za sekundu nesmí být větší než limit za minutu; jinak dostanete hlášku Hodnota nesmí překročit požadavky za minutu

Tlačítko Uložit zůstává nedostupné, dokud obě pravidla neplatí — a taky dokud hodnoty nezměníte oproti tomu, co už je uložené.

Jak se limit počítá

Počítadlo se váže na kalendářní sekundu a minutu, ne na klouzavé okno. Jakmile naskočí nová sekunda (u minutového limitu nová minuta), počítadlo začíná znovu od nuly.

Jak limit zruším

Šipka vedle tlačítka Upravit rozbalí nabídku s volbou Smazat. Potvrzovací okno Smazat limity požadavků API se zeptá Opravdu chcete smazat limity požadavků API? — po potvrzení už API tempo volání neomezuje.