来源白名单 GET 提取接口

GET /api/v1/proxy/extract 不使用控制台登录态。服务端仅根据真实来源 IPv4 查找启用中的唯一白名单归属。

GET 请求示例

curl 'https://api.zzhttp.com/api/v1/proxy/extract?num=1&regions=GLOBAL&protocol=http&return_type=json&lb=1'

这个请求会按调用机器的真实来源 IPv4 创建一次新的提取授权。示例选择全球、1 个 HTTP 代理网关；它可通过 CONNECT 访问 HTTPS 目标。调用前请确认该来源 IPv4 已在当前账号的活动白名单中。

调用条件

• 来源 IPv4 已加入当前账号白名单并启用。
• 账号已实名且拥有协议匹配的可用动态住宅权益。
• 请求不经过改变来源的额外代理。

接受参数

• num 必须显式传入，范围为 1–100；regions=GLOBAL 可替换为控制台当前提供的国家代码。
• protocol 只接受 http 或 socks5，return_type 为 json 或 txt；lb 控制 TXT 分隔符。
• 每次调用由服务端生成新的请求 ID。
• 调用方传入的身份声明不参与归属。

返回

• TXT 直接返回按分隔符组织的 IP:PORT。
• JSON 直接返回只含公开 ip 和 port 的数组。
• 结果顺序随机，不能依赖索引稳定。

安全

• 链接仅部署在受控服务端。
• 限制调用频率并避免写入公开日志。
• 来源变化后先更新白名单。