Lists API

The Lists API poskytuje rozhraní pro programovou správu následujících typů seznamů:

Vlastní seznamy: Obsahují jeden nebo více řetězců stejného typu (jako IP adresy nebo hostnames), na které se můžete ve výrazech pravidel odkazovat souhrnně podle názvu.
Bulk Redirect Lists: Obsahují URL přesměrování, která povolíte vytvořením Bulk Redirect Rule.

Použití seznamu ve výrazu pravidla viz Seznamy v dokumentaci jazyka Rules.

Začínáme

Pro začátek si projděte Lists JSON objekt a Endpointy.

Rate limiting požadavků na Lists API

Cloudflare může uplatnit rate limiting na vaše API požadavky vytvářející, upravující nebo mažící položky ve vlastních seznamech a Bulk Redirect Lists.

Každá operace (vytvoření, úprava nebo smazání) nad položkou seznamu se počítá jako modifikace. Platí následující limity:

V API požadavcích můžete provést maximálně 1 000 000 modifikací položek seznamů za 12 hodin.
Při modifikacích položek seznamů můžete provést maximálně 30 000 API požadavků za 12 hodin.

Pokud se zápisová operace stále zpracovává — což probíhá asynchronně — a odešlete nový požadavek, obdržíte 429 stavový kód HTTP. Pokud k tomu dojde, odešlete požadavek znovu později.