Usare un proxy

Quando risolvere tramite il tuo proxy e come inviarlo.

Quando serve un proxy

La maggior parte dei siti accetta un token risolto da un altro indirizzo IP, quindi i nomi senza proxy funzionano per quasi tutti i task. Usa il tuo proxy quando il sito verifica che il token sia stato risolto dallo stesso IP che lo invia, o quando un tipo lo richiede (DataDome, pagina Cloudflare Challenge).

Come inviarlo

Usa il nome del tipo di task senza Proxyless e aggiungi i campi proxy al task. Puoi inviarli separati o come una sola stringa proxy; la stringa viene suddivisa per te.

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"
  }
}

Campi proxy

proxyType

StringObbligatorio

http, https, socks4 o socks5.

proxyAddress

StringObbligatorio

Indirizzo IP o nome host del proxy.

proxyPort

IntegerObbligatorio

Porta del proxy.

proxyLogin

StringFacoltativo

Nome utente del proxy, se richiesto.

proxyPassword

StringFacoltativo

Password del proxy, se richiesta.

proxy

String

Tutti i campi proxy in una stringa, ad esempio http://user:pass@1.2.3.4:8080.

Da sapere

Il proxy deve essere raggiungibile da internet e restare attivo mentre il task è in corso.
Se il risolutore non riesce a connettersi, il task fallisce con ERROR_PROXY_CONNECTION_FAILED e viene rimborsato.
Se in un task con proxy mancano proxyAddress o proxyPort, viene restituito subito ERROR_BAD_PROXY, senza addebito.
I campi proxy inviati con un nome senza proxy vengono rimossi.
I dati del proxy vengono eliminati al termine del task.