## Na čo slúžia limity správ

Limit správ stráži, koľko správ smie jedna aplikácia odoslať za deň. Portál ho
popisuje ako `Mechanizmus na nastavenie a monitorovanie limitov správ pre toto API.`
a sám uvádza dôvod: udržať používanie API pod kontrolou, aby nevznikli nežiaduce
finančné náklady alebo aby niekto kanál nezneužil.

Limit sa dá rozdeliť na jednotlivé krajiny a k tomu sa určuje, čo sa stane so
správami nad limit — či počkajú, odídu na druhý deň, alebo sa zahodia.

> [!NOTE]
> Táto stránka popisuje `Limity správ API`, teda počet odoslaných správ. Koľko
> požiadaviek smie aplikácia poslať na API, rieši samostatná stránka
> [Limity požiadaviek API](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/limity-api-poziadaviek/).

## Kde limity 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 posuňte sa nižšie do časti `Limity API`

Dlaždica `Limity správ API` ukazuje aktuálne nastavenie v troch riadkoch —
`Maximálny počet správ API za deň`, `Limit správ pre krajinu` a `Nadlimitné akcie`.
Kým nie je nič nastavené, je tu namiesto nich `Nemáte žiadne nastavenia.` a tlačidlo
`Konfigurovať`.

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

## Ako limity nastavím

Tlačidlom `Konfigurovať` (alebo `Upraviť`, ak limity už máte) sa otvorí okno
`Limity správ API` s tromi krokmi. Medzi nimi sa pohybujete tlačidlami `Ďalší`
a `Späť`, uloží sa až posledným tlačidlom `Uložiť`.

### Krok 1 — Maximálny počet správ API za deň

Zadajte, koľko správ smie aplikácia odoslať za jeden deň. Bez kladného čísla sa
tlačidlo `Ďalší` neodomkne.

![Prvý krok s maximálnym počtom správ za deň](docs:api-limits/limit-step-total_cs)

### Krok 2 — Limit správ pre krajinu

Buď necháte `Bez obmedzenia`, alebo zvolíte `Nastavte vlastný limit pre konkrétnu
krajinu` a v poli `Vyhľadajte krajinu` vyberiete krajiny, ktoré chcete riešiť zvlášť. Každá sa
pridá do zoznamu, kde jej nastavíte jeden z troch režimov:

| Režim | Čo znamená |
|:--|:--|
| `API maximum` | Krajina čerpá zo spoločného denného limitu, vlastný strop nemá |
| `Limit` | Krajina má vlastný denný limit, ktorý zadáte do poľa vedľa |
| `Blokovať` | Do krajiny sa neodošle nič |

Hneď ako je v zozname viac ako jedna položka, pribudne riadok `Ostatné krajiny`, ktorým
nastavíte režim pre všetky zostávajúce krajiny naraz. Ikona koša krajinu zo zoznamu
odoberie.

![Druhý krok s limitmi pre jednotlivé krajiny](docs:api-limits/limit-step-country_cs)

### Krok 3 — Nadlimitné akcie

Portál sa opýta `Čo robiť so správami, ktoré prekračujú limit?` a ponúkne tri
možnosti:

| Voľba | Správanie |
|:--|:--|
| `Uložiť správy do priečinka Na odoslanie` | Správy nad limit sa uložia do priečinka Na odoslanie na neskoršie spracovanie |
| `Pošlite zajtra` | Správy nad limit odídu nasledujúci deň v čase, ktorý pri voľbe nastavíte |
| `Zahodiť správy` | Správy nad limit sa zahodia |

![Tretí krok s nadlimitnými akciami](docs:api-limits/limit-step-policy_cs)

> [!WARNING]
> Blokovaná krajina sa riadi vlastným pravidlom — správy do nej sa zahodia bez ohľadu
> na to, ktorú nadlimitnú akciu máte nastavenú.

## Ako sledujem vyčerpanie limitu

Nad kartami `Nastavenie` a `Štatistiky` je panel `Dnešný stav limitov API`
s percentom vyčerpania a ukazovateľom priebehu. Keď limit rozdelíte na krajiny, pribudne
riadok pre každú z nich; pri blokovanej krajine je namiesto ukazovateľa `odmietnutý`.

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

Pri 80 % portál upozorní hláškou `Váš denný limit bude čoskoro prekročený.`, pri
vyčerpaní celého limitu `Dosiahli ste svoj denný limit API!`.

Tlačidlom `Obnoviť limit` vynulujete počítadlo dnešných správ — potvrdzovacie
okno upozorní, že `Počítadlo správ odoslaných dnes sa vynuluje.` Ikonou
vedľa riadku krajiny sa dá vynulovať len tá jedna krajina. Kým aplikácia dnes nič
neodoslala, je tlačidlo nedostupné.

## Upozornenie na neobvyklú prevádzku

Okrem limitov, ktoré si nastavíte sami, sleduje portál aj to, ako sa prevádzka vašej
aplikácie vyvíja v čase. Porovnáva dnešné odoslané správy s tým, čo aplikácia
posielala v predchádzajúcom období, a keď sa výrazne rozídu, upozorní vás.

Rozlišuje dva prípady:

| Čo sa stane | Ako sa to prejaví |
|:--|:--|
| Do krajiny, kam vaša aplikácia bežne neposiela, začnú odchádzať správy | Správy sa uložia do priečinka Na odoslanie a upozornenie príde e-mailom aj SMS |
| Do krajiny, kam posielate bežne, ide výrazne viac správ ako zvyčajne | Odosielanie pokračuje, upozornenie príde e-mailom |

Prvý prípad je teda zároveň poistka — správy počkajú, kým ich nepotvrdíte,
bez ohľadu na to, akú nadlimitnú akciu máte nastavenú.

> [!IMPORTANT]
> Táto kontrola beží len vtedy, keď nemáte v kroku `Limit správ pre krajinu`
> nastavené vlastné limity pre jednotlivé krajiny. Hneď ako si krajiny ošetríte sami,
> portál sa riadi vaším nastavením a trendy nestráži.

Aby vás portál nezahltil, pošle na ten istý jav len niekoľko upozornení a potom
stíchne. Potrebuje tiež históriu odosielania — pri čerstvo založenej aplikácii, ktorá
zatiaľ nemá čo s čím porovnávať, sa trendy nevyhodnocujú.

## Ako limity zruším

Šípka vedľa tlačidla `Upraviť` rozbalí ponuku s voľbou `Zmazať`. Potvrdzovacie
okno `Odstráňte limity rozhrania API` upozorní, že po zmazaní už API odosielanie správ podľa
limitov obmedzovať nebude.