式の検証

Cloudflare Filters APIは、式を検証するためのエンドポイントをサポートしています。

例

クエリ文字列を介して式を検証

リクエスト

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": "フィルタ解析エラー:\n`ip.src==34`\n          ^^ ネットワーク内のアドレスを解析できませんでした: 無効なIPアドレス構文\n"
    }
  ],
  "messages": null
}

レスポンス内の検証エラーに注意してください。この例では、エラーは無効なIPアドレス形式によるものです：

フィルタ解析エラー:
`ip.src==34`
          ^^ ネットワーク内のアドレスを解析できませんでした: 無効なIPアドレス構文

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": "フィルタ解析エラー:\n`ip.src in {2400:cb00::/32 2405:8100::/2000 2c0f:f248::/32 2a06:98c0::/29}`\n                                        ^^^^ 数値がターゲット型に収まるには大きすぎます: 基数10で解析中\n"
    }
  ],
  "messages": null
}

レスポンス内の検証エラーに注意してください。この例では、サブネットマスクの値/2000は無効なIPv6 CIDRマスクです：

フィルタ解析エラー:
`ip.src in {2400:cb00::/32 2405:8100::/2000 2c0f:f248::/32 2a06:98c0::/29}`
                                       ^^^^ 数値がターゲット型に収まるには大きすぎます: 基数10で解析中