## K čemu limity zpráv slouží

Limit zpráv hlídá, kolik zpráv smí jedna aplikace odeslat za den. Portál ho
popisuje jako `Mechanismus pro nastavení a sledování limitů zpráv pro toto API.`
a sám uvádí důvod: udržet používání API pod kontrolou, aby nevznikly nežádoucí
finanční náklady nebo aby někdo kanál nezneužil.

Limit se dá rozpadnout na jednotlivé země a k tomu se určuje, co se stane se
zprávami nad limit — jestli počkají, odejdou druhý den, nebo se zahodí.

> [!NOTE]
> Tahle stránka popisuje `Limity zpráv API`, tedy počet odeslaných zpráv. Kolik
> požadavků smí aplikace poslat na API, řeší samostatná stránka
> [Limity požadavků API](https://www.bulkgate.com/cs/dokumentace/api-administrace-a-tokeny/limitace-api-pozadavku/).

## Kde limity 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 zpráv API` ukazuje aktuální nastavení ve třech řádcích —
`Maximální počet zpráv API za den`, `Limit zpráv pro zemi` a `Nadlimitní akce`.
Dokud nic nastavené není, je tu místo nich `Nemáte žádná nastavení.` a tlačítko
`Konfigurovat`.

![Dlaždice Limity zpráv API v detailu aplikace](docs:api-limits/limit-card_cs)

## Jak limity nastavím

Tlačítkem `Konfigurovat` (nebo `Upravit`, pokud limity už máte) se otevře okno
`Limity zpráv API` se třemi kroky. Mezi nimi se pohybujete tlačítky `Další`
a `Zpět`, uloží se až posledním tlačítkem `Uložit`.

### Krok 1 — Maximální počet zpráv API za den

Zadejte, kolik zpráv smí aplikace odeslat za jeden den. Bez kladného čísla se
tlačítko `Další` neodemkne.

![První krok s maximálním počtem zpráv za den](docs:api-limits/limit-step-total_cs)

### Krok 2 — Limit zpráv pro zemi

Buď necháte `Bez omezení`, nebo zvolíte `Nastavte vlastní limit pro konkrétní
zemi` a v poli `Hledat zemi` vyberete země, které chcete řešit zvlášť. Každá se
přidá do seznamu, kde jí nastavíte jeden ze tří režimů:

| Režim | Co znamená |
|:--|:--|
| `API maximum` | Země čerpá ze společného denního limitu, vlastní strop nemá |
| `Omezit` | Země má vlastní denní limit, který zadáte do pole vedle |
| `Blokovat` | Do země se neodešle nic |

Jakmile je v seznamu víc než jedna položka, přibude řádek `Ostatní země`, kterým
nastavíte režim pro všechny zbývající země najednou. Ikona koše zemi ze seznamu
odebere.

![Druhý krok s limity pro jednotlivé země](docs:api-limits/limit-step-country_cs)

### Krok 3 — Nadlimitní akce

Portál se zeptá `Co dělat se zprávami, které překračují limit?` a nabídne tři
možnosti:

| Volba | Chování |
|:--|:--|
| `Uložit zprávy do složky k odeslání` | Zprávy nad limit se uloží do složky k odeslání pro pozdější zpracování |
| `Pošlete zítra` | Zprávy nad limit odejdou následující den v čase, který u volby nastavíte |
| `Zahodit zprávy` | Zprávy nad limit se zahodí |

![Třetí krok s nadlimitními akcemi](docs:api-limits/limit-step-policy_cs)

> [!WARNING]
> Blokovaná země se řídí vlastním pravidlem — zprávy do ní se zahodí bez ohledu
> na to, kterou nadlimitní akci máte nastavenou.

## Jak sleduji vyčerpání limitu

Nad kartami `Nastavení` a `Statistiky` je panel `Dnešní stav limitů API`
s procentem vyčerpání a ukazatelem průběhu. Když limit rozpadnete na země, přibude
řádek pro každou z nich; u blokované země je místo ukazatele `zamítnuto`.

![Panel Dnešní stav limitů API](docs:api-limits/limit-status_cs)

Při 80 % portál upozorní hláškou `Váš denní limit bude brzy překročen.`, při
vyčerpání celého limitu `Dosáhli jste svého denního limitu API!`.

Tlačítkem `Resetovat limit` vynulujete počítadlo dnešních zpráv — potvrzovací
okno upozorní, že `Počítadlo zpráv odeslaných dnes bude vynulováno.` Ikonou
vedle řádku země se dá vynulovat jen ta jedna země. Dokud aplikace dnes nic
neodeslala, je tlačítko nedostupné.

## Upozornění na neobvyklý provoz

Kromě limitů, které si nastavíte sami, sleduje portál i to, jak se provoz vaší
aplikace vyvíjí v čase. Porovnává dnešní odeslané zprávy s tím, co aplikace
posílala v předchozím období, a když se obojí výrazně rozejde, upozorní vás.

Rozlišuje dva případy:

| Co se stane | Jak se to projeví |
|:--|:--|
| Do země, kam vaše aplikace běžně neposílá, začnou odcházet zprávy | Zprávy se uloží do složky k odeslání a upozornění dorazí e-mailem i SMS |
| Do země, kam posíláte běžně, jde výrazně víc zpráv než obvykle | Odesílání pokračuje, upozornění dorazí e-mailem |

První případ je tedy zároveň pojistka — zprávy počkají, dokud je nepotvrdíte,
bez ohledu na to, jakou nadlimitní akci máte nastavenou.

> [!IMPORTANT]
> Tahle kontrola běží jen tehdy, když nemáte v kroku `Limit zpráv pro zemi`
> nastavené vlastní limity pro jednotlivé země. Jakmile si země ošetříte sami,
> portál se řídí vaším nastavením a trendy nehlídá.

Aby vás portál nezahltil, pošle na tentýž jev jen několik upozornění a pak
zmlkne. Potřebuje také historii odesílání — u čerstvě založené aplikace, která
zatím nemá co s čím porovnávat, se trendy nevyhodnocují.

## Jak limity zruším

Šipka vedle tlačítka `Upravit` rozbalí nabídku s volbou `Smazat`. Potvrzovací
okno `Odstraňte limity API` upozorní, že po smazání už API odesílání zpráv podle
limitů omezovat nebude.