Tu primera resolución de CAPTCHA en solvethree

1. 1.

   Regístrate y configura tu espacio de trabajo

   Empieza por el registro. Usa el mismo espacio de trabajo para tu clave de API, tu perfil de sitio y tu saldo.

2. 2.

   Crea una clave

   Abre Claves de API en la consola. Selecciona Crear clave de API, introduce un Nombre de la clave y, después, selecciona Crear clave.

3. 3.

   Guarda el secreto

   Copia el secreto que aparece en Guarda tu clave de API y guárdalo de forma segura antes de seleccionar He guardado esta clave. Mostrar prefijos no permitirá recuperar el secreto completo más adelante. Guarda la clave en tu servidor, no en el código del navegador.

El saldo de bienvenida es de $5. Si necesitas añadir fondos, el depósito mínimo es de $10. reCAPTCHA cuesta $2.00 por cada 1,000 resoluciones; una tarea en estado ready se factura y una resolución fallida se reembolsa.

1. 1.

   Añade la página de destino

   Abre Perfiles de sitio y selecciona Añadir un sitio. Introduce la URL de la página HTTPS del destino y elige Enterprise v3.

2. 2.

   Configura la acción de captura

   Usa la acción necesaria para la operación que estás integrando. El ejemplo de solicitud siguiente usa login, así que úsala solo si es la acción real del destino. Añade un perfil por cada combinación de nombre de host, acción de captura y tipo de reCAPTCHA.

3. 3.

   Espera a que el estado sea activo

   Selecciona Añadir sitio. Algunas cuentas verán primero Añadir saldo para continuar. Según el envío, el perfil puede pasar por estados de captura, validación o revisión. Continúa solo cuando esté activo; no hay una duración de captura garantizada. Si la captura falla, lee el motivo antes de volver a intentarlo.

Enviar un nombre de host y una acción en una tarea no crea un perfil. Para esta primera resolución, usa en la tarea la acción de captura exacta del perfil. Consulta la configuración de perfiles de sitio para conocer los campos opcionales y la selección de acciones.

Envía el siguiente cuerpo a POST https://api.solvethree.com/v1/tasks. Autentícate con la cabecera Authorization usando Bearer seguido de tu clave de API del espacio de trabajo.

{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}

• Sustituye site por el nombre de host del destino, no por la URL completa de su página. Sustituye action por la acción seleccionada para tu primera resolución.
• Sustituye proxy por la URL y las credenciales de tu proxy HTTP. Esta solicitud usa un solo proxy; no envíes también proxyCandidates.
• Elige un requestId para esta solicitud lógica y guárdalo junto con los datos de entrada enviados. Admite entre 1 y 64 caracteres: letras ASCII, números, guiones bajos o guiones.
• Omite type y url. Si se omite recaptchaType, la solicitud usa Enterprise v3 de forma predeterminada.

Para una implementación completa en Python, usa reCAPTCHA Enterprise en Python. La solicitud que se muestra aquí indica los valores que debes preparar primero.

Guarda el ID de tarea devuelto al crearla. Consulta la tarea con GET https://api.solvethree.com/v1/tasks/:id, sustituyendo :id por ese ID y usando la misma autenticación Bearer.

• Comprueba si la respuesta HTTP es no satisfactoria antes de leer el cuerpo como una respuesta de tarea correcta.
• Mientras el estado sea pending o solving, sigue consultando periódicamente. Ninguno de los dos estados contiene una solución utilizable.
• Cuando el estado sea ready, deja de consultar y lee solution.
• Cuando el estado sea failed, deja de consultar e inspecciona errorCode y error. La resolución fallida se reembolsa.

Una respuesta en estado ready tiene esta estructura. Estos valores de token e identidad de navegador son ejemplos, no una solución real.

{
  "id": "example-task",
  "status": "ready",
  "solution": {
    "token": "EXAMPLE_TOKEN",
    "userAgent": "EXAMPLE_USER_AGENT",
    "secChUa": "EXAMPLE_CLIENT_HINTS"
  }
}

1. 1.

   Envía el token, no el ID de tarea

   Coloca solution.token donde el destino previsto espere su token de reCAPTCHA. Inspecciona la solicitud saliente para asegurarte de que no esté enviando el ID de tarea ni un token antiguo.

2. 2.

   Usa la identidad de navegador devuelta

   Usa solution.userAgent y solution.secChUa en la solicitud al destino, junto con el mismo proxy proporcionado para esta resolución. No los combines con una identidad de navegador ajena ni envíes el token a una URL de destino diferente.

3. 3.

   Comprueba la respuesta del destino

   Confirma que el destino haya aceptado la operación prevista. Una tarea en estado ready significa que solvethree generó una solución; no garantiza que el destino acepte tu solicitud posterior.

Antes de iniciar un lote, consigue que el destino acepte esta única solicitud. Si la rechaza, comprueba el token enviado, la identidad de navegador, el proxy y la URL de destino antes de comprar más resoluciones.