登录态 POST 提取接口

POST /api/v1/proxy/extract 用于已登录用户在控制台中批量提取代理地址。请求会校验实名、权益、白名单归属和参数。

请求结构

{
  "requestId": "<request-id>",
  "entitlementId": "<entitlement-id>",
  "whitelistId": "<whitelist-id>",
  "country": "<country-code>",
  "quantity": 10,
  "protocol": "HTTP",
  "agreementConfirmed": true
}

请求字段

• requestId 是当前用户内的幂等标识。
• entitlementId 和 whitelistId 必须属于当前用户。
• country、quantity 和 protocol 决定本批结果。
• agreementConfirmed 表示用户已确认使用约定。

数量与协议

• quantity 为 1–100，控制台默认 10。
• 协议使用接口当前提供的 HTTP、HTTPS 或 SOCKS5 枚举。
• 地区使用控制台提供的国家或全球值。

响应

• 成功返回本次公开网关地址和无登录态 GET 链接。
• 调用方不得依赖结果顺序。
• 提取本身不扣流量，真实代理字节在网关结算。

错误处理

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