Lists API

Lists API предоставляет интерфейс для программного управления следующими типами списков:

Пользовательские списки: Содержат одну или несколько строк одного типа (например, IP-адреса или имена хостов), на которые можно ссылаться вместе, по имени, в выражениях правил.
Bulk Redirect Lists: Содержат перенаправления URL, которые включаются путём создания Bulk Redirect Rule.

Чтобы использовать список в выражении правила, см. Lists в документации по языку Rules language.

Начало работы

Чтобы начать, изучите раздел Списки Объект JSON и Конечные точки.

Ограничение скорости для запросов Lists API

Cloudflare может применять ограничение скорости к вашим запросам API на создание, изменение или удаление элементов списков в пользовательских списках и Bulk Redirect Lists.

Каждая операция (создание, изменение или удаление) над элементом списка считается изменением. Действуют следующие ограничения:

С помощью API запросов можно выполнить не более 1,000,000 изменений элементов списка за 12 часов.
Для изменения элементов списка можно выполнить не более 30,000 API запросов за 12 часов.

Если операция записи всё ещё обрабатывается (а это происходит асинхронно) и вы отправляете новый запрос, вы получите 429 HTTP-код состояния. В этом случае отправьте запрос повторно позже.