Utiliser un proxy

Quand résoudre via votre propre proxy et comment l'envoyer.

Quand utiliser un proxy

La plupart des sites acceptent un token résolu depuis une autre adresse IP, donc les noms sans proxy conviennent à la plupart des tâches. Utilisez votre propre proxy quand le site vérifie que le token a été résolu depuis la même IP que celle qui le soumet, ou quand un type l'exige (DataDome, page Cloudflare Challenge).

Comment l'envoyer

Utilisez le nom du type de tâche sans Proxyless et ajoutez les champs proxy à la tâche. Vous pouvez les envoyer séparément ou en une seule chaîne proxy ; la chaîne est découpée automatiquement.

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

Champs proxy

proxyType

StringObligatoire

http, https, socks4 ou socks5.

proxyAddress

StringObligatoire

Adresse IP ou nom d'hôte du proxy.

proxyPort

IntegerObligatoire

Port du proxy.

proxyLogin

StringFacultatif

Nom d'utilisateur du proxy, si le proxy en demande un.

proxyPassword

StringFacultatif

Mot de passe du proxy, si le proxy en demande un.

proxy

String

Tous les champs proxy dans une seule chaîne, par exemple http://user:pass@1.2.3.4:8080.

Bon à savoir

Le proxy doit être accessible depuis internet et rester actif pendant l'exécution de la tâche.
Si le résolveur ne peut pas se connecter, la tâche échoue avec ERROR_PROXY_CONNECTION_FAILED et est remboursée.
Si proxyAddress ou proxyPort manque dans une tâche avec proxy, ERROR_BAD_PROXY est renvoyé immédiatement, sans frais.
Les champs proxy envoyés avec un nom sans proxy sont supprimés.
Les informations de proxy sont supprimées à la fin de la tâche.