CC 防护

CC 匹配、过滤和规则管理。

📄️查询 CC 过滤器列表

查询 CC 防护过滤器。普通用户仅能查看自己的过滤器；管理员可按 uid 查询任意用户，并可使用 internal 筛选内部过滤器。ID 为 10020 的内置记录始终不在列表中。

创建 CC 防护过滤器。必须提供 name、type、within_second 和 max_req；req_rate 类型还必须提供 max_req_per_uri，url_auth 类型还必须提供 extra。普通用户只能为自己创建非内部过滤器；管理员可指定 uid 或创建内部过滤器。

批量更新 CC 防护过滤器。请求体必须为 JSON 数组；每项通常应提供 id，未传 id 时服务端会按创建逻辑处理该项。普通用户仅能操作自己的非内部过滤器，管理员可以操作任意记录。修改被 CC 规则使用的过滤器关键配置时会创建同步任务；禁用被规则使用的过滤器会被拒绝。

删除一个或多个 CC 过滤器。路径 id 可使用英文逗号分隔多个数字 ID。普通用户只能删除自己的非内部规则；管理员可删除其他用户或内部规则。每个目标必须已禁用，且关联同步任务（如有）状态必须为 done。

获取指定 CC 防护过滤器的原始记录。内部过滤器仅管理员可查看；普通用户只能查看自己的非内部过滤器。

更新路径指定的 CC 过滤器。路径 id 必须为数字，且会覆盖请求体中可能存在的 id。请求体必须为 JSON 对象，未提供的字段保持原值。普通用户只能操作自己的非内部规则；管理员可操作其他用户或内部规则。

查询当前用户可访问的 CC 请求匹配器。普通用户仅能查看自己的非内部记录；管理员可按 uid 查询用户记录，并可筛选内部记录。ID 为 10020 的记录不会出现在列表中。

创建 CC 防护匹配器。必须提供 name；data 为可选匹配条件数组。普通用户只能为自己创建非内部匹配器；管理员可指定 uid 或创建内部匹配器。

批量更新 CC 防护匹配器。请求体必须为 JSON 数组；每项通常应提供 id，未传 id 时服务端按创建逻辑处理该项。普通用户只能操作自己的非内部匹配器。修改被 CC 规则使用的匹配条件会创建同步任务；禁用被规则使用的匹配器会被拒绝。

删除一个或多个 CC 防护匹配器。路径 id 可使用英文逗号分隔多个数字 ID。每个匹配器必须已禁用，且关联同步任务（如有）状态必须为 done。普通用户只能删除自己的非内部匹配器，管理员可删除其他用户或内部匹配器。

查询路径指定的 CC 匹配器。普通用户只能查看自己的非内部记录；管理员可以查看内部记录及其他用户的记录。

更新指定 CC 防护匹配器。请求体必须为 JSON 对象，路径参数 id 会覆盖请求体中的 id；未传字段保持原值。普通用户只能操作自己的非内部匹配器。修改被 CC 规则使用的匹配条件会创建同步任务；禁用被规则使用的匹配器会被拒绝。

查询 CC 防护规则。普通用户默认只查看自己的规则；管理员可按 uid 查询任意用户。internal_self 可扩展为当前目标用户可见的内部/共享规则；internal 筛选仅管理员可用。ID 为 10020 的内置记录不会返回。

创建 CC 防护规则。普通用户只能创建自己的非内部规则；管理员可指定 uid、设置内部规则或共享范围。创建成功后服务端会创建同步任务。

批量更新或创建 CC 规则。请求体必须为 JSON 数组；每项带 id 时更新已有规则，不带 id 时创建新规则。普通用户只能操作自己的非内部规则；管理员可操作其他用户或内部规则。规则被网站引用时，更新规则项会创建同步任务；禁用受引用规则会被拒绝。

删除一个或多个 CC 防护规则。路径 id 可使用英文逗号分隔多个数字 ID。每个规则必须已禁用；如有关联任务，其状态必须为 done。普通用户只能删除自己的非内部规则，管理员可删除其他用户或内部规则。

获取指定 CC 防护规则的原始记录。内部规则仅管理员可查看；普通用户只能查看自己的非内部规则。

更新路径指定的 CC 规则。路径 id 必须为数字，并会覆盖请求体中同名字段。请求体必须为 JSON 对象，未提供的字段保持原值。普通用户只能操作自己的非内部规则；管理员可操作其他用户或内部规则。更新被网站引用的规则项会创建同步任务；禁用规则受网站引用、默认规则和内置规则限制。