使用 Cloudflare API配置可编程流量防护。
API 调用示例请参阅常见 API 调用。
若要获取完整端点,请将下方列出的可编程流量防护 API 端点附加到 Cloudflare API 基础 URL:
https://api.cloudflare.com/client/v4{account_id} 参数是帐户 ID(十六进制字符串)。你可以在 Cloudflare 控制面板中找到此值。
以下各节中的表格总结了可用操作。
每个上传的程序都从版本 1 开始。使用 PATCH 请求更新程序时,会在同一程序 ID 下创建新版本。程序响应会在 version 字段中包含当前版本。
每条规则都固定到特定的程序版本,该版本显示在规则的 program_version 字段中。创建规则时若未指定 program_version,则会固定到程序的当前版本。更新程序不会更新引用该程序的现有规则。
若要将现有规则切换到程序的另一个成功版本,请向规则端点发送 PATCH 请求,并指定目标 program_version。示例请参阅更新规则。
| 操作 | 方法和端点 / 描述 |
|---|---|
| 列出程序 |
|
| 上传程序 |
X-Program-Name 请求头,以指定便于阅读的程序名称。如果省略,API 会生成 UUID 作为程序名称。 |
| 获取程序 |
|
| 更新程序 |
|
| 删除程序 |
|
| 删除所有程序 |
|
| 操作 | 方法和端点 / 描述 |
|---|---|
| 列出规则 |
|
| 创建规则 |
|
| 获取规则 |
|
| 更新规则 |
|
| 删除规则 |
|
| 删除所有规则 |
|
| 操作 | 方法和端点 / 描述 |
|---|---|
| 使用 PCAP 调试 |
|
返回项目列表的 API 操作使用分页。有关可用分页查询参数的更多信息,请参阅分页。