API de reCAPTCHA Enterprise v3

Por solvethree Actualizado

Obtén un token de reCAPTCHA v3 Enterprise desde tu backend. Configura el sitio una vez y después envía su nombre de host, la acción y un proxy. Devolveremos el token con el agente de usuario y los client hints que debes usar al enviarlo.

Probar la API
En esta página

Realiza la solicitud

Configura un perfil de sitio activo en tu espacio de trabajo antes de la primera resolución. Envía el nombre de host en site y la acción real de reCAPTCHA de la página en action. Enterprise v3 es la opción predeterminada; usa recaptchaType: v3 para la versión v3 estándar. La tarea no necesita un type, la URL completa de la página ni una clave de sitio.

Crea la tarea con POST https://api.solvethree.com/v1/tasks. Autentícate con una clave de API del espacio de trabajo en la cabecera Authorization: Bearer.

Cuerpo de la tarea · sustituye el destino y el proxy del ejemplo
{
  "site": "example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example-recaptcha-001"
}

Envía el token

Lee solution.token cuando la tarea esté lista. Envíalo en el campo CAPTCHA de tu aplicación a través del mismo proxy, usando los valores devueltos de userAgent y secChUa. Realiza la resolución poco antes de la solicitud que necesita el token; no crees una caché de tokens para usarlos más tarde.

Una tarea en estado ready significa que se ha generado la solución. Comprueba la respuesta del destino para saber si aceptó la solicitud.

Espera y tiempos de espera agotados

La creación espera hasta 15 segundos de forma predeterminada. Usa ?waitMs=0 si prefieres recibir un ID de tarea de inmediato y consultar su estado periódicamente.

Detente en ready o failed. Si se agota el tiempo de espera de la creación, reutiliza el requestId original con entradas idénticas para recuperar la tarea. Un ID nuevo puede crear otra resolución facturable.

Precio

$2.00 por 1,000 resoluciones, con cargo al saldo de tu espacio de trabajo. Las resoluciones fallidas se reembolsan. Empieza con $5 de crédito de bienvenida; el depósito mínimo de pago es de $10.

API de reCAPTCHA Enterprise v3 · solvethree