UNLOCK API
使用代理

使用代理

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

何時需要代理

大多數網站接受從其他 IP 位址辨識的權杖,所以無代理名稱適用於大多數任務。如果網站會檢查權杖是否由提交它的同一 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,不收費。
  • 隨無代理名稱傳送的代理欄位會被移除。
  • 代理資訊會在任務結束時刪除。