Lists API 提供以编程方式管理以下类型列表的接口：
-
自定义列表 (Custom lists)：包含一种或多种相同类型的字符串（例如 IP 地址或主机名），可在规则表达式中按名称整体引用。
-
批量重定向列表 (Bulk Redirect Lists)：包含 URL 重定向，可通过创建批量重定向规则启用。
要在规则表达式中使用列表，请参阅 Rules 语言文档中的 Lists。
开始前，请先查看 Lists 的 JSON object 与 Endpoints。
Cloudflare 可能会对您创建、修改或删除自定义列表与 Bulk Redirect Lists 中列表项的 API 请求应用速率限制。
对列表项的每次操作（创建、编辑或删除）都计为一次修改。适用以下限制：
- 在 12 小时内，API 请求中的列表项修改次数最多为 1,000,000 次。
- 在 12 小时内，用于列表项修改的 API 请求最多为 30,000 次。
如果某次写入操作仍在处理中（该处理是异步进行的）而您又提交了新请求，将收到 429 HTTP 状态码。出现此情况时，请稍后重新提交请求。