Rychlost odesílání

JSON API využívá bucket policy pro omezování propustnosti. Výchozí bucket policy je nastavena na 1000 požadavků za vteřinu pro bucket size 5000. To znamená, že v jeden okamžik se může odbavit až 5000 požadavků zároveň (bucket size) a každou vteřinu se doplňuje počet dostupných požadavků o 1000 až do velikosti 5000.

Každý API klíč využívá své vlastní bucket policy dle toho, kolik průměrně požadavků za vteřinu odesíláte.

V každém případě je možné se setkat s chybou 429 Too Many Requests. V takovém případě opakujte požadavek později. Je obecně doporučeno implementovat backoff algoritmus pro odesílání požadavků (to znamená, že po získání chyby 429 se čas po který čekáte mezi požadavky zvětšuje), nicm=ně není to vyžadováno.

Bucket policy

Více o tom, jak tento algoritmus funguje, naleznete na Wikipedii.

Lze tedy předpokládat, že při průměrném počtu 1000 požadavků za vteřinu nebude odesílání omezeno. Zároveň je možné krátkodobě přijmout i více požadavků, než je průměrný počet za vteřinu (až 5x).

Propustnost na http-api a xml-api

Výchozí propustnost na těchto starších verzích API je na 100 požadavků za vteřinu pro bucket size 500. To znamená, že v jeden okamžik se může odbavit až 500 požadavků zároveň (bucket size) a každou vteřinu se doplňuje počet dostupných požadavků o 100 až do velikosti 500.