跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

Lists API(列表 API)

最后更新 查看 MarkdownAgent 设置

Lists API 提供以编程方式管理以下类型列表的接口:

要在规则表达式中使用列表,请参阅 Rules 语言文档中的 Lists。

快速入门

开始前,请先查看 Lists 的 JSON object 与 Endpoints。


Lists API 请求的速率限制

Cloudflare 可能会对您创建、修改或删除自定义列表与 Bulk Redirect Lists 中列表项的 API 请求应用速率限制。

对列表项的每次操作(创建、编辑或删除)都计为一次修改。适用以下限制:

  • 在 12 小时内,API 请求中的列表项修改次数最多为 1,000,000 次。
  • 在 12 小时内,用于列表项修改的 API 请求最多为 30,000 次。

如果某次写入操作仍在处理中(该处理是异步进行的)而您又提交了新请求,将收到 429 HTTP 状态码。出现此情况时,请稍后重新提交请求。

CrowdSec 管理的列表

由 CrowdSec 集成保持更新的列表受到更严格的限制:每 24 小时只能对每个此类列表执行一次批量操作。

如果超过此限制,API 将拒绝请求,并返回 HTTP 状态码 429 和错误代码 10040。响应不包含 operation_id,因为请求在创建批量操作之前就已被拒绝。

为避免达到此限制,请将自动更新安排为最多每 24 小时运行一次,或者使用单独的自定义列表执行更频繁的更新。

这篇文档对您有帮助吗?