Lists API

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

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

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

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

Для начала изучите раздел Lists JSON-объект и Эндпоинты.

Rate limiting для запросов Lists API

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

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

Через API-запросы можно выполнить не более 1 000 000 модификаций элементов списков за 12 часов.
Можно выполнить не более 30 000 API-запросов с модификациями элементов списков за 12 часов.

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