ReCaptchaV2: resolviendo reCAPTCHA v2

TIP

Crea la tarea con el método createTask y obtén el resultado con el método getTaskResult.

Los tipos de tareas types que admitimos son:

ReCaptchaV2TaskProxyLess utiliza el proxy incorporado en el servidor.
ReCaptchaV2EnterpriseTask este tipo de tarea requiere tus propios proxies.
ReCaptchaV2EnterpriseTaskProxyLess utiliza el proxy incorporado en el servidor.

Crear Tarea

Crea una tarea de reconocimiento con el método createTask.

Antes de crear una tarea, si necesita usar fichas en herramientas de automatización como dramaturgo y títeres, es posible que necesite encontrar sus funciones de devolución de llamadas. Referencia:

Cómo encontrar la función de devolución de llamada de cada versión de reCaptcha

Estructura del Objeto de Tarea

WARNING

Si no sabe cómo establecer parámetros, utilice la Extensión CapSolver para obtener automáticamente los parámetros requeridos.

Artículo de referencia: Cómo detectar cualquier Captcha y extraer sus parámetros

Si encuentra que el token v2 no es válido, utilice la Extensión CapSolver para obtener la configuración JSON y enviarla a nuestro servicio al cliente para su configuración. Después de la configuración, mejorará en gran medida la puntuación del token.

Artículo de referencia: Cómo resolver reCAPTCHA v2, invisible v2, v3, v3 Enterprise ≥0.9 puntuación)

Propiedades	Tipo	Requerido	Descripción
type	String	Required	`ReCaptchaV2TaskProxyLess` `ReCaptchaV2EnterpriseTask` `ReCaptchaV2EnterpriseTaskProxyLess`
websiteURL	String	Required	Dirección web del sitio web que utiliza generalmente es un valor fijo. (Ejemplo: https://google.com)
websiteKey	String	Required	La clave pública de dominio, raramente actualizada. (Ejemplo: b989d9e8-0d14-41sda0-870f-97b5283ba67d)
proxy	String	Optional	Aprende Cómo usar proxies
pageAction	String	Optional	Para sitios v2: pase el parámetro `sa` si está disponible en la solicitud `anchor`. Para sitios v3: busque `grecaptcha.execute` para encontrar el parámetro `action`.
enterprisePayload	Object	Optional	Para la versión empresarial, busque `grecaptcha.enterprise.render` y pase el parámetro s
isInvisible	Bool	Optional	Pase verdadero si no hay una casilla de verificación “No soy un robot”, pero el desafío seguirá apareciendo, generalmente requerido en el modo invisible v2
isSession	Bool	Optional	El modo de sesión, al estar habilitado, devolverá un valor `recaptcha-ca-t`, que se usa como cookie y suele aparecer en la versión 3. Nota: Algunos sitios web requieren un valor `recaptcha-ca-e`, que suele aparecer en la versión 2. Si existe dicho valor, se devolverá automáticamente; no se requieren otros ajustes.
apiDomain	String	Optional	El nombre de dominio para cargar el código de verificación. Normalmente, no es necesario pasar este parámetro. • http://www.google.com/ • http://www.recaptcha.net/

Ejemplo de Solicitud

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ReCaptchaV2Task",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "enterprisePayload": {
      "s": "SOME_ADDITIONAL_TOKEN" // Optional
    },
    "isInvisible": false, // Optional
    "pageAction": "submit", // Optional
    "apiDomain": "", // Optional
    "proxy": "http:ip:port:user:pass", // socks5:ip:port:user:pass, Optional
  }
}

Después de enviar la tarea a nosotros, deberías recibir en la respuesta un ‘ID de tarea’ si es exitoso. Por favor, lee errorCode: lista completa de errores si no recibiste el ID de tarea.

Ejemplo de Respuesta

{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Obteniendo Resultados

Después de obtener el taskId, debes enviar el taskId para recuperar la solución. La estructura de la respuesta se

explica en getTaskResult.

Dependiendo de la carga del sistema, obtendrás los resultados dentro del intervalo de 1s a 10s.

Ejemplo de Solicitud

POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
 
{
    "clientKey": "YOUR_API_KEY",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Ejemplo de Respuesta

{
    "errorId": 0,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
        "userAgent": "xxx", // User-Agent
        "secChUa": "xxx", // Sec-Ch-Ua
        "createTime": 1671615324290, // Tiempo de generación del token
        "gRecaptchaResponse": "3AHJ......", // Token de respuesta
        "recaptcha-ca-t": "AbEM......", // Algunos sitios web v3 tienen modo de sesión. Tras habilitar isSession, este parámetro se devolverá y se usará como cookie.
        "recaptcha-ca-e": "Abp_......" // Algunos sitios web v2 tienen este parámetro, que se utiliza como cookie. Si existe dicho valor, se devolverá automáticamente.
    },
    "status": "ready"
}

Uso de Solicitud de SDK

#pip install --upgrade capsolver
#export CAPSOLVER_API_KEY='...'
 
import capsolver
# capsolver.api_key = "..."
solución = capsolver.solve({
            "type": "ReCaptchaV2TaskProxyLess",
            "websiteURL": "https://www.google.com/recaptcha/api2/demo",
            "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
          })

Geetest reCAPTCHA v3