Nic nenalezeno

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

Poznámka

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

  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

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

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ě

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

Upozornění

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

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.

Důležité

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.

Byla tato stránka užitečná?