← Cloudflare Firewall Rules / firewall / api / cf-filters

Проверка выражений

Cloudflare Filters API поддерживает конечную точку для проверки выражений.

Примеры

Проверка выражения с помощью query string

Запрос

curl "https://api.cloudflare.com/client/v4/filters/validate-expr?expression=ip.src==34" \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>"

Ответ

{
  "result": null,
  "success": false,
  "errors": [
    {
      "message": "Filter parsing error:\n`ip.src==34`\n          ^^ couldn't parse address in network: invalid IP address syntax\n"
    }
  ],
  "messages": null
}

Обратите внимание на ошибку валидации в ответе. В этом примере ошибка вызвана недопустимым форматом IP-адреса:

Filter parsing error:
`ip.src==34`
          ^^ couldn't parse address in network: invalid IP address syntax

Проверка выражения с помощью объекта JSON

Запрос

curl "https://api.cloudflare.com/client/v4/filters/validate-expr" \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
  "expression": "ip.src in {2400:cb00::/32 2405:8100::/2000 2c0f:f248::/32 2a06:98c0::/29}"
}'

Ответ

{
  "result": null,
  "success": false,
  "errors": [
    {
      "message": "Filter parsing error:\n`ip.src in {2400:cb00::/32 2405:8100::/2000 2c0f:f248::/32 2a06:98c0::/29}`\n                                        ^^^^ number too large to fit in target type while parsing with radix 10\n"
    }
  ],
  "messages": null
}

Обратите внимание на ошибку валидации в ответе. В этом примере значение маски подсети, /2000, не является допустимой маской IPv6 CIDR:

Filter parsing error:
`ip.src in {2400:cb00::/32 2405:8100::/2000 2c0f:f248::/32 2a06:98c0::/29}`
                                       ^^^^ number too large to fit in target type while parsing with radix 10