UNLOCK API
使用代理

使用代理

何時要透過自己的代理識別,以及如何發送代理。

何時需要代理

大多數網站接受從其他 IP 地址識別的 token,所以無代理名稱適用於大多數任務。如網站會檢查 token 是否由提交它的同一 IP 識別,或類型本身需要代理(DataDome、Cloudflare Challenge 頁面),請使用你自己的代理。

如何發送

使用不含 Proxyless 的任務類型名稱,並在任務中加上代理欄位。可以分別發送,也可以發送一個 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,不收費。
  • 隨無代理名稱發送的代理欄位會被移除。
  • 代理資料會在任務結束時刪除。