查询动态 IP 白名单
分页查看当前账户的动态 IP 来源白名单,可按状态或 IP 筛选。
只只HTTP技术团队维护更新于 2026年10月6日
接口与认证
GET
/openapi/v1/proxy/whitelist/list仅查询本人白名单,精确 IP 过滤。
使用 HTTPS;唯一非空 api_key Query,仅接受账户 API 令牌。
示例为合成数据与占位凭据,仅说明结构。接口合同不代表目标环境已开放,开放状态以控制台为准。
下载 OpenAPI · 导入 Apifox / Postman请求参数
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
api_key | string | 是 | Query · 唯一非空 | 账户 API 令牌,在受控服务端保存;示例使用占位符。 |
page | integer | 否 | query · 默认 1;最小 1 | 页码,默认 1。 |
page_size | integer | 否 | query · 默认 20;最小 1;最大 100 | 每页条数,默认 20,最大 100。 |
status | string | 否 | query · 默认 all;枚举 all / active / disabled | 状态过滤。 |
ip | string | 否 | query · — | 来源 IP 精确筛选。 |
无请求体。
请求示例
curl --request GET \
"https://api.zzhttp.com/openapi/v1/proxy/whitelist/list?api_key=${API_KEY}"成功响应
成功或逐项批量结果,请同时核对业务码。
响应不含内部字段或代理密码。提取 HTTP 200 / code 0 为成功;白名单及国家目录 code 200 为成功。POST 提取的错误使用 code/message 格式;国家目录成功响应没有 requestId。
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
code | integer | 是 | — | 成功为 200;白名单批量任一失败为 10431。 |
message | string | 是 | — | 结果说明。 |
requestId | string | 是 | — | 请求追踪 ID。 |
data | object | 是 | — | 本接口业务数据。 |
data.items | object[] | 是 | — | 当前页本人白名单。 |
data.items[].whitelist_id | integer | 是 | 最小 1 | 白名单记录 ID。 |
data.items[].ip | string | 是 | — | 来源 IPv4 地址,精确匹配。 |
data.items[].remark | string | 是 | — | 客户备注,最长 255 字符。 |
data.items[].status | integer | 是 | 枚举 1 / 3 | 1 启用,3 停用;已删除记录不返回。 |
data.items[].created_at | string | 是 | 格式 date-time | 创建时间,RFC3339。 |
data.page | integer | 是 | — | 页码,从 1 开始。 |
data.page_size | integer | 是 | — | 每页条数。 |
data.total | integer | 是 | — | 筛选后的总记录数。 |
{
"code": 200,
"message": "查询成功",
"requestId": "demo-request-001",
"data": {
"items": [
{
"whitelist_id": 101,
"ip": "203.0.113.10",
"remark": "office",
"status": 1,
"created_at": "2026-10-06T08:00:00Z"
}
],
"page": 1,
"page_size": 20,
"total": 1
}
}错误与重试
每个令牌查询 60 次/分钟,添加或删除各 10 次/分钟。429 按 Retry-After 等待;写入结果不明先查询列表,仅重试未成功项。
错误码、HTTP 状态、错误响应字段及恢复方式统一见错误码与处理建议。
这篇内容解决了你的问题吗?
反馈只用于改进公开文档,不会提交账号或请求信息。