Prueba la API de CAPTCHA en Insomnia

Por solvethree4 min de lectura

Crea una tarea con un cuerpo JSON, copia el ID de tarea devuelto y después consulta esa tarea hasta que su estado sea ready o failed. No necesitas encadenar respuestas para esta prueba.

En esta página

Prepara tu configuración local

Necesitas una clave de API del espacio de trabajo, un perfil activo para el sitio de destino y un proxy. Configura el perfil del sitio antes de enviar la tarea: proporcionar un nombre de host y una acción no crea un perfil.

Usa un entorno local privado llamado solvethree-local con las variables siguientes. Estos nombres se han elegido para esta guía; no son campos adicionales de la API. Mantén la clave de API y las credenciales del proxy fuera de las configuraciones compartidas.

Variables del entorno local
Variables del entorno local
NombreValor
api_basehttps://api.solvethree.com/v1
api_keyTu clave de API privada del espacio de trabajo.
siteEl nombre de host configurado en tu perfil de sitio activo, no la URL completa de una página.
actionLa acción de reCAPTCHA que usa la solicitud de destino.
proxyLa URL de tu proxy HTTP o HTTPS, sin ruta, consulta ni fragmento.
request_idUn identificador para esta tarea lógica: entre 1 y 64 letras ASCII, números, guiones bajos o guiones.
task_idDéjalo vacío hasta que la respuesta de creación proporcione el ID de la tarea.

Crea la tarea y copia su ID

  1. 1.

    Configurar la solicitud de creación

    Crea una solicitud POST usando api_base seguido de /tasks. Añade el parámetro de consulta waitMs con el valor 0. Selecciona la autenticación Bearer y proporciona api_key como token; la solicitud debe enviar un encabezado Authorization con el esquema Bearer.

  2. 2.

    Prepara el cuerpo JSON

    Elige un cuerpo JSON que contenga site, action, proxy y requestId. Rellena los tres primeros con sus variables locales correspondientes y requestId con request_id. Envía exactamente uno de los campos proxy o proxyCandidates; esta guía usa proxy. No añadas type ni url. Si omites recaptchaType, se selecciona el valor predeterminado, enterprise-v3.

  3. 3.

    Envía la solicitud e inspecciona la respuesta

    Comprueba la respuesta HTTP antes de interpretarla como los datos de una tarea correcta. Si la creación se completa correctamente, copia el ID de tarea devuelto en task_id. Conserva el cuerpo de la tarea y request_id por si necesitas recuperar la solicitud.

  4. 4.

    Consulta esa tarea

    Crea una solicitud GET usando api_base seguido de /tasks/ y el ID de tarea copiado. Establece waitMs en 15000, usa la misma clave Bearer y deja el cuerpo vacío. Copia el ID manualmente; esta guía no depende de una expresión de encadenamiento de respuestas.

Insomnia · solicitudes de creación y recuperación
Create task
  Method: POST
  URL: https://api.solvethree.com/v1/tasks?waitMs=0
  Auth: Bearer Token — your private workspace key
  Body: JSON — site, action, proxy and a stable requestId

Retrieve task
  Method: GET
  URL: https://api.solvethree.com/v1/tasks/PASTE_RETURNED_ID?waitMs=15000
  Auth: Bearer Token — the same workspace key
  Body: none

Keep the task's proxy in the JSON body. Insomnia's own network proxy setting
controls its API connection, not the proxy used to generate/submit the solution.

Decide qué hacer con la respuesta

La solicitud HTTP devuelve una respuesta no satisfactoria.

Inspecciona el error HTTP antes de intentar leer los datos de una tarea correcta.

Prueba esto: Corrige el problema de solicitud o autenticación indicado. No envíes repetidamente entradas no válidas sin modificarlas ni supongas que todos los errores indican saldo insuficiente.

La tarea está en estado pending o solving.

Ninguno de estos estados contiene una solución utilizable.

Prueba esto: Vuelve a enviar la solicitud GET para el mismo ID de tarea. No crees otra tarea solo porque esta no haya terminado.

La tarea está en estado failed.

Lee errorCode y error; site-unreachable es uno de los posibles errores de tarea.

Prueba esto: Deja de consultar esa tarea y corrige la causa indicada antes de iniciar otra. Las resoluciones fallidas se reembolsan.

La solicitud de creación agota el tiempo de espera sin devolver un ID.

Que se agote el tiempo de espera de la conexión no demuestra que la creación haya fallado.

Prueba esto: Vuelve a enviar el mismo cuerpo de tarea con el mismo requestId para recuperar la tarea existente. Cambiar las entradas mientras reutilizas ese ID provoca un conflicto.

Una tarea de reCAPTCHA en estado ready proporciona un token. Si lo envías al destino, usa los valores devueltos de userAgent y secChUa con el mismo proxy utilizado para la resolución. Una respuesta de estado listo confirma que se ha generado una solución, no que la solicitud de tu aplicación se haya completado correctamente.

Ejecuta tu primera tarea.

Empieza con $5 de crédito en tu espacio de trabajo.

Crear un espacio de trabajo
Prueba la API de CAPTCHA en Insomnia · solvethree