# 查询动态 IP 白名单

分页查看当前账户的动态 IP 来源白名单，可按状态或 IP 筛选。

## 请求

`GET /openapi/v1/proxy/whitelist/list` 使用[账户 API 令牌](/developers/authentication/api-token)认证。

| 查询参数 | 必填 | 说明 |
| --- | --- | --- |
| `api_key` | 是 | 完整账户 API 令牌，每次请求只传一次 |
| `page` | 否 | 默认 `1` |
| `page_size` | 否 | 默认 `20`，最大 `100` |
| `status` | 否 | `all`、`active` 或 `disabled`，默认 `all` |
| `ip` | 否 | 精确 IP 筛选 |

```bash
curl --get 'https://api.zzhttp.com/openapi/v1/proxy/whitelist/list' \
  --data-urlencode "api_key=$API_KEY" \
  --data-urlencode 'status=all'
```

`API_KEY` 从密钥管理系统注入，不记录完整请求 URL。

## 返回与错误

成功条目只含 `whitelist_id`、`ip`、`remark`、数字状态和 `created_at`；不返回软删除、归属版本及网关内部字段。参数错误应先修正；令牌无效为 HTTP `401`，限流为 `429`，按 `Retry-After` 等待。每个令牌最多查询 60 次/分钟；临时服务故障可有限重试读取。

html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}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 pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}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);}