Prueba solvethree en Postman
Importa la colección de Postman sin credenciales, configura valores de entorno privados y envía Crear tarea una vez. Después, usa Recuperar tarea para consultar esa misma tarea hasta que termine. La colección no tiene pruebas automáticas ni scripts que envíen tareas adicionales.
En esta página
Importa y configura la colección
- 1.
Importa el JSON descargado
En Postman, elige Importar y selecciona el archivo de la colección. Contiene Crear tarea y Recuperar tarea con autorización Bearer heredada y marcadores de posición para variables.
- 2.
Comprueba el perfil del sitio
Tu espacio de trabajo necesita un perfil activo para el nombre de host de destino. Configúralo en la consola antes de hacer pruebas; enviar un nombre de host y una acción no crea un perfil. Consulta la configuración del perfil del sitio.
- 3.
Configura valores de entorno privados
Crea y selecciona un entorno para esta prueba. Introduce los valores siguientes de forma privada, incluidas las credenciales del proxy, si las hay. No incluyas secretos directamente en la colección ni los exportes con sus valores.
- 4.
Configura la autorización Bearer
En el nivel de la colección, selecciona Bearer Token y referencia una variable de entorno privada que contenga la clave de API de tu espacio de trabajo. Mantén ambas solicitudes configuradas para heredar la autorización. La API espera Authorization: Bearer seguido de esa clave.
| Variable | Qué introducir |
|---|---|
| SOLVETHREE_API_KEY | La clave de API privada de tu espacio de trabajo. El token Bearer de la colección referencia esta variable. |
| SITE | El nombre de host de destino, no la URL completa de una página. |
| ACTION | La acción de reCAPTCHA que usa la solicitud de destino. |
| PROXY | La URL del proxy HTTP o HTTPS para esta prueba, incluidas las credenciales si son necesarias. |
| REQUEST_ID | Un valor nuevo para cada nueva tarea lógica: de 1–64 caracteres ASCII entre letras, números, guiones bajos o guiones. |
| TASK_ID | Déjalo vacío al principio. Tras la creación, copia aquí el id devuelto. |
Envía Crear tarea una vez
Abre Crear tarea. Envía un POST a https://api.solvethree.com/v1/tasks con un cuerpo JSON sin procesar cuyos valores proceden del entorno seleccionado.
{
"site": "{{SITE}}",
"action": "{{ACTION}}",
"proxy": "{{PROXY}}",
"requestId": "{{REQUEST_ID}}"
}Esta solicitud usa reCAPTCHA Enterprise v3 de forma predeterminada. No añadas los campos type ni url. Proporciona un único proxy, así que no añadas también proxyCandidates: se requiere exactamente uno de esos campos.
Define REQUEST_ID antes de enviar y haz clic en Enviar una vez. Comprueba primero la respuesta HTTP. Si no es satisfactoria, revisa el error de la solicitud en lugar de tratar el cuerpo como una respuesta de tarea satisfactoria. Corrige los datos de entrada no válidos en lugar de enviarlos repetidamente sin cambios.
Si la respuesta de creación es satisfactoria, copia el id devuelto en tu valor de entorno privado TASK_ID. No vuelvas a hacer clic en Crear tarea solo para comprobar el progreso.
Recuperar la tarea existente
Abre Recuperar tarea y confirma que TASK_ID contiene el ID de tarea devuelto. Esta solicitud usa GET /v1/tasks/:id en la misma API. Envíala manualmente, comprueba la respuesta HTTP y después revisa el status de la tarea.
| Estado | Siguiente acción |
|---|---|
| pending o solving | La tarea no ha terminado. Espera y vuelve a enviar Recuperar tarea con el mismo TASK_ID. |
| listo | Deja de consultar. La tarea contiene una solución utilizable. |
| failed | Deja de consultar. Revisa errorCode y error para decidir qué hay que cambiar. Las resoluciones fallidas se reembolsan. |
Un HTTP 200 o 201 por sí solo no significa que haya una solución lista; solo status: ready lo indica. Esta prueba manual comprueba la creación y la recuperación de tareas, no si el sitio web de destino acepta el resultado.
Si continúas enviando el token de reCAPTCHA a su destino previsto, usa la identidad de navegador devuelta en userAgent y secChUa y el proxy que funcionó. No cambies de IP ni mezcles una identidad de navegador ajena. El destino puede rechazar un token aunque esté listo.
Si se agota el tiempo de espera de Crear tarea
Un tiempo de espera de conexión agotado no demuestra que la creación haya fallado. Si tienes el ID de la tarea, recupérala. Si nunca recibiste el ID, vuelve a enviar Crear tarea con el mismo REQUEST_ID y los datos de entrada de la tarea sin modificar. Así recuperas la tarea existente en lugar de crear otra tarea lógica.
No generes un REQUEST_ID nuevo solo porque se haya perdido la respuesta. Reutilizar un ID con datos de entrada diferentes provoca un conflicto; usa un ID nuevo cuando inicies una tarea nueva de forma deliberada.
Fuentes y referencia de la API
Ejecuta tu primera tarea.
Empieza con $5 de crédito en tu espacio de trabajo.