批量添加动态 IP 白名单
使用账户令牌将最多 100 个海外公网 IPv4 添加到账户白名单。
只只HTTP技术团队维护更新于 2026年10月6日
接口与认证
POST
/openapi/v1/proxy/whitelist/add逐项白名单写入,不回滚其他已成功项。超过 100 或外层结构无效整批拒绝。示例保留 IP 仅展示结构,实际添加会拒绝文档地址。
使用 HTTPS;唯一非空 api_key Query,仅接受账户 API 令牌。
示例为合成数据与占位凭据,仅说明结构。接口合同不代表目标环境已开放,开放状态以控制台为准。
下载 OpenAPI · 导入 Apifox / Postman请求参数
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
api_key | string | 是 | Query · 唯一非空 | 账户 API 令牌,在受控服务端保存;示例使用占位符。 |
请求示例 · application/json
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
items | object[] | 是 | 最少项 1;最多项 100 | 每项独立处理,1–100 个海外公网 IPv4。 |
items[].ip | string | 是 | — | 获授权的海外公网 IPv4;IPv6、私网和保留地址拒绝。 |
items[].remark | string | 否 | 最长 255 | 可选备注。 |
请求示例
curl --request POST \
"https://api.zzhttp.com/openapi/v1/proxy/whitelist/add?api_key=${API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"items":[{"ip":"203.0.113.10","remark":"office"}]}'成功响应
成功或逐项批量结果,请同时核对业务码。
响应不含内部字段或代理密码。提取 HTTP 200 / code 0 为成功;白名单及国家目录 code 200 为成功。POST 提取的错误使用 code/message 格式;国家目录成功响应没有 requestId。
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
code | integer | 是 | — | 成功为 200;白名单批量任一失败为 10431。 |
message | string | 是 | — | 结果说明。 |
requestId | string | 是 | — | 请求追踪 ID。 |
data | object | 是 | — | 本接口业务数据。 |
data.success_count | integer | 是 | — | 成功处理条数。 |
data.failed_count | integer | 是 | — | 失败条数。 |
data.failed_items | object[] | 是 | — | 失败明细;成功地址不在响应中列出。 |
data.failed_items[].ip | string | 是 | — | 失败地址。 |
data.failed_items[].code | integer | 是 | — | 此项数字错误码。 |
data.failed_items[].reason | string | 是 | — | 失败原因。 |
{
"code": 200,
"message": "处理完成",
"requestId": "demo-request-001",
"data": {
"success_count": 1,
"failed_count": 0,
"failed_items": []
}
}错误与重试
每个令牌查询 60 次/分钟,添加或删除各 10 次/分钟。429 按 Retry-After 等待;写入结果不明先查询列表,仅重试未成功项。
错误码、HTTP 状态、错误响应字段及恢复方式统一见错误码与处理建议。
这篇内容解决了你的问题吗?
反馈只用于改进公开文档,不会提交账号或请求信息。