Uso de proxy

Cuándo resolver a través de tu propio proxy y cómo enviarlo.

Cuándo necesitas un proxy

La mayoría de los sitios aceptan un token resuelto desde otra dirección IP, así que los nombres sin proxy sirven para la mayoría de las tareas. Usa tu propio proxy cuando el sitio comprueba que el token se resolvió desde la misma IP que lo envía, o cuando un tipo lo requiere (DataDome, página Cloudflare Challenge).

Cómo enviarlo

Usa el nombre del tipo de tarea sin Proxyless y agrega los campos de proxy a la tarea. Puedes enviarlos por separado o como una sola cadena proxy; la cadena se divide automáticamente.

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

Campos de proxy

proxyType

StringObligatorio

http, https, socks4 o socks5.

proxyAddress

StringObligatorio

Dirección IP o nombre de host del proxy.

proxyPort

IntegerObligatorio

Puerto del proxy.

proxyLogin

StringOpcional

Usuario del proxy, si el proxy lo requiere.

proxyPassword

StringOpcional

Contraseña del proxy, si el proxy la requiere.

proxy

String

Todos los campos de proxy en una sola cadena, por ejemplo http://user:pass@1.2.3.4:8080.

A tener en cuenta

El proxy debe ser accesible desde internet y seguir activo mientras se ejecuta la tarea.
Si el resolvedor no puede conectarse, la tarea falla con ERROR_PROXY_CONNECTION_FAILED y se reembolsa.
Si falta proxyAddress o proxyPort en una tarea con proxy, se devuelve ERROR_BAD_PROXY de inmediato, sin cobro.
Los campos de proxy enviados con un nombre sin proxy se eliminan.
Los datos de proxy se borran cuando la tarea termina.