Limity požiadaviek API

Čo limit požiadaviek obmedzuje

Limit požiadaviek stráži, ako často smie vaša aplikácia zavolať API — teda počet požiadaviek, nie počet odoslaných správ. Portál na to sám upozorňuje v nastaveniach:

Nastavenie tohto limitu obmedzuje počet žiadostí API, nie počet odoslaných správ. Po dosiahnutí limitu API vráti kód HTTP 429 Too Many Requests a správy nie sú akceptované.

Jedna požiadavka pritom môže niesť aj stovky správ, takže tento limit chráni niečo iné ako Limity správ API — stráži tempo volaní, nie objem odoslaného.

Kde limit nájdem

1. V menu portálu kliknite na Moduly a API
2. V časti Moje API a Moduly kliknite na kartu svojej aplikácie
3. Zostaňte na karte Nastavenie a zíďte nižšie do časti Limity API

Dlaždica Limity žiadostí API ukazuje nastavené hodnoty v dvoch riadkoch — Maximálny počet žiadostí za minútu a Maximálny počet žiadostí za sekundu. Kým nie je nič nastavené, je tu Nemáte žiadne nastavenia. a tlačidlo Konfigurovať.

Ako limit nastavím

Tlačidlo Konfigurovať (alebo Upraviť, ak už limit máte) otvorí okno Limity žiadostí API s dvoma nezávislými voľbami:

Začiarknutím voľby sa odkryje pole Zadajte Počet žiadostí. Zapnúť môžete jednu z nich alebo obe zároveň.

Nastavenia strážia dve pravidlá:

• najmenšia prijateľná hodnota je 1 — inak vás portál upozorní hláškou Minimálna hodnota je 1
• ak zapnete obe voľby, limit za sekundu nesmie byť väčší ako limit za minútu; inak dostanete hlášku Hodnota nesmie prekročiť požiadavky za minútu

Tlačidlo Uložiť zostáva nedostupné, kým obe pravidlá neplatia — a tiež kým hodnoty nezmeníte oproti tomu, čo je už uložené.

Ako sa limit počíta

Počítadlo sa viaže na kalendárnu sekundu a minútu, nie na kĺzavé okno. Hneď ako naskočí nová sekunda (pri minútovom limite nová minúta), počítadlo začína znova od nuly.

Ako limit zruším

Šípka vedľa tlačidla Upraviť rozbalí ponuku s voľbou Zmazať. Potvrdzovacie okno Odstrániť limity žiadostí API sa opýta Naozaj chcete odstrániť limity žiadostí API? — po potvrdení už API tempo volaní neobmedzuje.