## Č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](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/limity-api/) — stráži tempo volaní, nie
objem odoslaného.

> [!IMPORTANT]
> Keď sa limit vyčerpá, API odmietne **celú požiadavku**. Správy v nej sa nikam
> neuložia ani sa neodošlú neskôr — na rozdiel od limitu správ, kde sa s nadlimitnými
> správami zaobchádza podľa nastavenej nadlimitnej akcie.

## 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ť`.

![Dlaždica Limity žiadostí API v detaile aplikácie](docs:api-request-limits/request-limit-card_cs)

## 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:

| Voľba | Čo nastavuje |
|:--|:--|
| `Aktivujte limit žiadostí API za minútu` | Koľko požiadaviek smie aplikácia poslať počas jednej minúty |
| `Aktivujte limit žiadostí API za sekundu` | Koľko požiadaviek smie aplikácia poslať počas jednej sekundy |

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

![Okno s nastavením limitov požiadaviek](docs:api-request-limits/request-limit-settings_cs)

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.

> [!TIP]
> Limit za sekundu sa hodí na vyhladenie špičiek, limit za minútu na celkové tempo.
> Keď nastavíte oba, platia oba zároveň — požiadavka prejde, len keď sa zmestí
> do oboch.

## 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.