Робота через проксі

Коли розв'язувати через власний проксі та як його передати.

Коли потрібен проксі

Більшість сайтів приймають токен, розв'язаний з іншої 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"
  }
}

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "RecaptchaV2Task",
    "websiteURL": "https://example.com/login",
    "websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo",
    "proxy": "http://user:pass@1.2.3.4:8080"
  }
}

Поля проксі

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, безкоштовно.
Поля проксі, надіслані з назвою без проксі, видаляються.
Дані проксі видаляються, коли задача завершується.