账户令牌 POST 提取接口
公开动态 API 的认证、参数和响应字段说明。
只只HTTP技术团队维护更新于 2026年10月6日
接口与认证
POST
/openapi/v1/proxy/extract使用账户 API 令牌或历史 API Link 认证；实际来源 IPv4 必须在本人启用白名单，提取校验实名和协议匹配权益。GET/POST 提取为 兼容格式，不支持会话、州省和城市参数。
使用 HTTPS；api_key Query、X-API-Key 或 Authorization: Bearer 支持同值认证，冲突值拒绝。实际来源白名单仍须有效。
示例为合成数据与占位凭据，仅说明结构。接口合同不代表目标环境已开放，开放状态以控制台为准。
下载 OpenAPI · 导入 Apifox / Postman请求参数
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
api_key | string | 否 | Query · 或认证请求头 | 账户 API 令牌，在受控服务端保存；示例使用占位符。 |
请求示例 · application/json
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
requestId | string | 否 | — | 可选业务请求号；网络中断后使用同号重试。 |
entitlementId | integer | 否 | — | 可选本人权益 ID，省略由服务端选择。 |
whitelistId | integer | 否 | — | 可选本人白名单 ID；实际来源仍需一致。 |
quantity | integer | 是 | 最小 1；最大 100 | 请求条数，1–100。 |
protocol | string | 是 | 枚举 HTTP / HTTPS / SOCKS5 | 代理协议。 |
country | string | 否 | 默认 GLOBAL | 国家代码，省略按全球处理。 |
agreementConfirmed | boolean | 是 | 固定 true | 必须确认使用协议。 |
请求示例
curl --request POST \
"https://api.zzhttp.com/openapi/v1/proxy/extract?api_key=${API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"requestId":"extract-demo-001","quantity":1,"protocol":"HTTP","country":"GLOBAL","agreementConfirmed":true}'成功响应
成功或逐项批量结果，请同时核对业务码。
响应不含内部字段或代理密码。提取 HTTP 200 / code 0 为成功；白名单及国家目录 code 200 为成功。POST 提取的错误使用 code/message 格式；国家目录成功响应没有 requestId。
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
code | integer | 是 | 固定 0 | 兼容成功码为 0，与静态 API 成功码 200 不同。 |
success | boolean | 是 | 固定 true | 成功标记。 |
msg | string | 是 | — | 结果说明。 |
data | object[] | 是 | — | 本接口业务数据。 |
data[].ip | string | 是 | — | 代理网关 IP 或主机名。 |
data[].port | integer | 是 | — | 代理网关端口。 |
request_ip | string | 是 | — | 服务端识别的真实调用来源 IPv4。 |
{
"code": 0,
"success": true,
"msg": "Successfully obtained",
"data": [
{
"ip": "203.0.113.20",
"port": 7878
}
],
"request_ip": "198.51.100.10"
}错误与重试
请求中断复用原 requestId/request_id；部分返回通过 X-Proxy-Requested-Count、X-Proxy-Returned-Count 与 X-Proxy-Partial 判断。资源不足按 Retry-After 等待，国家目录可有限重试读取。
错误码、HTTP 状态、错误响应字段及恢复方式统一见错误码与处理建议。
这篇内容解决了你的问题吗？
反馈只用于改进公开文档，不会提交账号或请求信息。