Lists API

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 (například IP adresy nebo hostname), na které lze ve výrazech pravidel hromadně odkazovat podle názvu.
Bulk Redirect Lists: Obsahují přesměrování URL adres, která povolíte vytvořením Bulk Redirect Rule.

Chcete-li použít seznam ve výrazu pravidla, přečtěte si Seznamy v dokumentaci k jazyku Rules language.

Začínáme

Chcete-li začít, projděte si Seznamy Objekt JSON a Endpointy.

Omezení frekvence požadavků na Lists API

Cloudflare může u vašich API požadavků na vytváření, úpravu nebo mazání položek seznamu ve vlastních seznamech a Bulk Redirect Lists uplatnit omezení frekvence požadavků.

Každá operace (vytvoření, úprava nebo odstranění) položky seznamu se počítá jako změna. Platí tyto limity:

Prostřednictvím API požadavků můžete provést maximálně 1,000,000 úprav položek seznamu za 12 hodin.
Můžete provést maximálně 30,000 API požadavků za 12 hodin týkajících se úprav položek seznamu.

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