UNLOCK API
获取 API 密钥
使用代理
MarkdownOpenAPI

使用代理

何时通过你自己的代理识别，以及如何发送代理。

何时需要代理

大多数网站接受从其他 IP 地址识别出的令牌，所以无代理名称适用于大多数任务。如果网站会检查识别令牌的 IP 与提交令牌的 IP 是否相同，或者某类型必须使用代理（DataDome、Cloudflare Challenge 页面），请使用你自己的代理。

如何发送

使用不带 Proxyless 的任务类型名称，并在 task 中加上代理字段。可以分别发送，也可以发送一个 proxy 字符串；字符串会自动拆分。
POST /createTask
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "RecaptchaV2Task",
    "websiteURL": "https://example.com/login",
    "websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo",
    "proxyType": "http",
    "proxyAddress": "1.2.3.4",
    "proxyPort": 8080,
    "proxyLogin": "user",
    "proxyPassword": "pass"
  }
}

代理字段

proxyType
String必填
http、https、socks4 或 socks5。
proxyAddress
String必填
代理 IP 地址或主机名。
proxyPort
Integer必填
代理端口。
proxyLogin
String可选
代理用户名（如果代理需要）。
proxyPassword
String可选
代理密码（如果代理需要）。
proxy
String
把所有代理字段写成一个字符串，例如 http://user:pass@1.2.3.4:8080。

注意事项

  • 代理必须能从互联网访问，并在任务运行期间保持在线。
  • 如果识别方无法连接，任务会以 ERROR_PROXY_CONNECTION_FAILED 失败并退款。
  • 代理任务缺少 proxyAddress 或 proxyPort 时，立即返回 ERROR_BAD_PROXY，不收费。
  • 随无代理名称发送的代理字段会被删除。
  • 代理信息在任务结束时删除。