Limity API
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í.
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.
Kde limity najdu
- V menu portálu klikněte na
Moduly a API - V části
Moje API a Modulyklikněte na kartu své aplikace - Zůstaňte na kartě
Nastavenía sjeďte do částiLimity 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.

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.

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.

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í |

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.

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.
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.
Děkujeme za zpětnou vazbu.