# 批量删除动态 IP 白名单

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

## 请求

`POST /openapi/v1/proxy/whitelist/delete` 使用[账户 API 令牌](/developers/authentication/api-token)认证，`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` 等待。请求中断后先[查询白名单](/developers/api/ip-whitelist-list)，只重试仍存在且归属当前账户的 IP。

html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}