跳到正文
本中心目录
API 文档 · 动态 IP 功能

批量删除动态 IP 白名单

按 IP 批量删除当前账户的动态 IP 来源白名单。

只只HTTP技术团队维护更新于 2026年9月29日

请求

POST /openapi/v1/proxy/whitelist/delete 使用账户 API 令牌认证,api_key 作为唯一、非空的查询参数。JSON 请求体的 ips 含 1–100 个 IP:

JSON
{"ips":["203.0.113.10"]}

示例 IP 是文档保留地址,仅说明字段结构。接口按 IP 删除,不要求先查询白名单记录 ID;删除既有记录不重新要求实名认证。

返回与错误

删除仅作用于当前账户。不存在与不归属当前账户均返回“白名单不存在”,不泄露其他账户归属。成功删除后立即释放全局所有权,已有连接自然结束。

全部成功时顶层 code=200;部分或全部条目失败时顶层 code=10431,data 包含 success_count、failed_count、failed_items[]。每项独立处理;超过 100 项或外层结构非法时整批不处理。删除每个令牌最多 10 次/分钟;HTTP 429 按 Retry-After 等待。请求中断后先查询白名单,只重试仍存在且归属当前账户的 IP。

这篇内容解决了你的问题吗?

反馈只用于改进公开文档,不会提交账号或请求信息。