登录态 POST 提取接口

POST /api/v1/proxy/extract 用于已登录用户在控制台中批量提取代理地址。请求会校验实名、权益、真实来源 IPv4 对应的活动白名单及参数。

请求结构

{
  "requestId": "demo-20260920-001",
  "country": "GLOBAL",
  "quantity": 1,
  "protocol": "HTTP",
  "format": "json",
  "agreementConfirmed": true
}

请求字段

• requestId 是当前用户内的幂等标识；每次新提取换一个值，重试原请求时复用原值。示例 ID 仅供演示。
• entitlementId 可选；传入时必须是当前用户可用的动态住宅权益，省略时服务端选择可用权益。实际授权按请求的真实来源 IPv4 对应的活动白名单判定，不能靠 whitelistId 声明来源。
• country、quantity 和 protocol 决定本批结果；format 选择 JSON 或 TXT。
• agreementConfirmed 表示用户已确认使用约定。

数量与协议

• quantity 为 1–100，控制台默认 10。
• 协议使用接口当前提供的 HTTP、HTTPS 或 SOCKS5 枚举。
• POST 的 HTTPS 枚举不能直接当作 GET 的 protocol=https 使用；如需复用返回的 GET 链接，使用 GET 支持的 HTTP 或 SOCKS5。访问 HTTPS 目标可通过 HTTP 代理建立 CONNECT 隧道。
• 地区使用控制台提供的国家或全球值。

响应

• 成功返回本次公开网关地址及 GET 链接；使用链接前核对其中的 protocol 是 GET 支持的 http 或 socks5。
• 调用方不得依赖结果顺序。
• 提取本身不扣流量，真实代理字节在网关结算。

错误处理

• 401 时重新登录。
• 10601 表示需要完成实名认证。
• 白名单、权益或参数错误应修正后再提交。