要调用 Cloudflare 过滤器 API 操作,请将端点附加到 Cloudflare API 基础 URL:
https://api.cloudflare.com/client/v4/有关身份验证的说明,请参考 Cloudflare API 文档中的 入门:请求 (Getting Started: Requests)。
有关端点和分页的帮助,请参考 入门:端点 (Getting Started: Endpoints)。
Cloudflare 过滤器 API 支持以下列出的操作。请访问本节中的页面以获取示例。
| 操作 | 方法 & 端点 | 说明 |
|---|---|---|
| 创建过滤器 | POST zones/<ZONE_ID>/filters | 作为单个事务处理。如果发生错误,则整个操作将失败。 |
| 获取过滤器 | GET zones/<ZONE_ID>/filters | 列出所有当前的过滤器。结果默认以每页 25 个项目分页返回。使用可选参数来缩小结果范围。 |
| 获取单个过滤器 | GET zones/<ZONE_ID>/filters/<FILTER_ID> | 通过 ID 检索单个过滤器。 |
| 更新过滤器 | PUT zones/<ZONE_ID>/filters | 作为单个事务处理。所有过滤器必须存在,操作才能成功。如果发生错误,则整个操作将失败。 |
| 更新单个过滤器 | PUT zones/<ZONE_ID>/filters/<FILTER_ID> | 通过 ID 更新单个过滤器。 |
| 删除过滤器 | DELETE zones/<ZONE_ID>/filters | 删除现有的过滤器。必须指定过滤器 ID 的列表。 空请求不会导致删除。如果指定的过滤器不存在,则返回 HTTP 状态码 200。 |
| 删除单个过滤器 | DELETE zones/<ZONE_ID>/filters/<FILTER_ID> | 通过 ID 删除过滤器。 |