查询动态 IP 白名单
分页查看当前账户的动态 IP 来源白名单，可按状态或 IP 筛选。
只只HTTP技术团队维护更新于 2026年9月29日
请求
GET /openapi/v1/proxy/whitelist/list 使用账户 API 令牌认证。
| 查询参数 | 必填 | 说明 |
|---|---|---|
api_key | 是 | 完整账户 API 令牌，每次请求只传一次 |
page | 否 | 默认 1 |
page_size | 否 | 默认 20，最大 100 |
status | 否 | all、active 或 disabled，默认 all |
ip | 否 | 精确 IP 筛选 |
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 次/分钟；临时服务故障可有限重试读取。
这篇内容解决了你的问题吗？
反馈只用于改进公开文档，不会提交账号或请求信息。