← Cloudflare Firewall Rules / firewall / api

Cloudflare Filters API

Cloudflare Filters это компонент правил брандмауэра, доступный только через API, для разработки сложных критериев, которые опираются на булевы операторы и другую логику при анализе входящего HTTP-трафика и поиске совпадений.

Например, фильтр, который соответствует условию:

• HTTP user agent и
• HTTP-путь и
• IP-адрес источника

Свяжите фильтр с правилом брандмауэра, чтобы определить область действия этого правила.

Списки IP-адресов внутри фильтра позволяют одновременно ссылаться на целую группу IP-адресов. Дополнительные сведения см. в Lists API, где это описано подробнее.

Прежде чем приступить к работе с Cloudflare Filters API, ознакомьтесь с правилами выражения. Полный справочник см. в Язык правил.

Firewall Rules API отличается от большинства API Cloudflare в двух аспектах:

• Вызовы API принимают и возвращают несколько элементов и позволяют применять изменения данных сразу к нескольким элементам.
• Хотя вызовы API возвращают стандартный ответ, объект ошибки соответствует Стандарт JSON API ↗, чтобы при возникновении ошибки было понятно, какой элемент её вызвал и почему.

Чтобы начать, ознакомьтесь с Что такое фильтр?, а затем Cloudflare Filters Объект JSON и Конечные точки.