Prueba la API de CAPTCHA en Insomnia
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.
| Nombre | Valor |
|---|---|
api_base | https://api.solvethree.com/v1 |
api_key | Tu clave de API privada del espacio de trabajo. |
site | El nombre de host configurado en tu perfil de sitio activo, no la URL completa de una página. |
action | La acción de reCAPTCHA que usa la solicitud de destino. |
proxy | La URL de tu proxy HTTP o HTTPS, sin ruta, consulta ni fragmento. |
request_id | Un identificador para esta tarea lógica: entre 1 y 64 letras ASCII, números, guiones bajos o guiones. |
task_id | Déjalo vacío hasta que la respuesta de creación proporcione el ID de la tarea. |
Crea la tarea y copia su ID
- 1.
Configurar la solicitud de creación
Crea una solicitud POST usando
api_baseseguido de/tasks. Añade el parámetro de consultawaitMscon el valor0. Selecciona la autenticación Bearer y proporcionaapi_keycomo token; la solicitud debe enviar un encabezadoAuthorizationcon el esquema Bearer. - 2.
Prepara el cuerpo JSON
Elige un cuerpo JSON que contenga
site,action,proxyyrequestId. Rellena los tres primeros con sus variables locales correspondientes yrequestIdconrequest_id. Envía exactamente uno de los camposproxyoproxyCandidates; esta guía usaproxy. No añadastypeniurl. Si omitesrecaptchaType, se selecciona el valor predeterminado,enterprise-v3. - 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 yrequest_idpor si necesitas recuperar la solicitud. - 4.
Consulta esa tarea
Crea una solicitud GET usando
api_baseseguido de/tasks/y el ID de tarea copiado. EstablecewaitMsen15000, 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.
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
pendingosolving. 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
errorCodeyerror;site-unreachablees 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
requestIdpara 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.
Fuentes y referencia de la API
Ejecuta tu primera tarea.
Empieza con $5 de crédito en tu espacio de trabajo.