Solucionador de captchas para
cURL
Resuelve el desafío dentro de la ejecución en lugar de dejar que falle el trabajo. Un ejemplo funcional en Shell y las tres cosas que deciden si se acepta tu token.
curl -X POST "https://api.captchano.com/v1/solve?wait=60" \
-H "Authorization: Bearer cn-YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "recaptcha_v2",
"sitekey": "6LcABC...",
"url": "https://example.com/login",
"proxy": "http://user:pass@host:port"
}'
# 200 OK
# { "id": "slv_…", "status": "ready",
# "solution": { "token": "03AGdBq25S…" },
# "cost": "0.00598", "solveTime": 18.4 }Qué decide si se acepta el token
- Pasa tu proxy. El token debe generarse detrás de la misma IP de salida que lo envía. En los sistemas que evalúan la sesión esto es obligatorio, no una optimización.
- Usa el mismo user agent. Turnstile y varios sistemas antibot vinculan el token a un user agent. Te devolvemos el que se usó para que puedas reproducirlo exactamente.
- Pídelo tarde. Los tokens caducan en unos 120 segundos. Solicita uno cuando estés listo para enviar.
Bloqueante o con sondeo
El ejemplo usa ?wait=60, así que la llamada devuelve la resolución terminada y tu paso de cURL sigue siendo lineal. Si prefieres no mantener una conexión abierta, quita el parámetro, guarda el id devuelto y consulta GET /v1/task/{id} cada cinco segundos. Un token que ya pagaste se puede recuperar durante diez minutos, así que una conexión caída no te hace perder la resolución.
Costo
$0.00598 por cada resolución exitosa de reCAPTCHA v2; las resoluciones fallidas nunca se cobran. Consulta los precios de cada tipo de desafío o la referencia de la API para ver la estructura completa de la solicitud.
Cómo encaja la resolución en cURL
La API es HTTPS y JSON sin más, así que cURL es la forma más rápida de ver una resolución de principio a fin antes de escribir código.
- 01Crea una clave
Crea una clave de API en el panel. Empieza por cn-.
- 02Envía una resolución
Envía por POST un JSON con type, sitekey y url a /v1/solve?wait=60 con una cabecera Authorization: Bearer.
- 03Lee la respuesta
status, solution.token, cost y solveTime llegan en un único objeto JSON.
- 04Consulta periódicamente si lo prefieres
Quita ?wait y consulta GET /v1/task/{id} cada pocos segundos.
Cómo meter el token en la página
Copias el token de la respuesta JSON al campo del formulario o a la petición que envía tu propio cliente.
Dónde suelen fallar las integraciones
Envía Content-Type: application/json o el cuerpo no se podrá parsear.
Envuelve el JSON entre comillas simples para que la shell no expanda nada de su interior.
Preguntas frecuentes sobre captchas en cURL
¿Necesito un SDK?
No. CaptchaNo es una API REST sencilla. Funciona cualquier cliente HTTP en cualquier lenguaje, y cURL es la forma más fácil de probarla.
¿Cómo consulto mi saldo?
Llama a GET /v1/balance con la misma cabecera Authorization. El panel también muestra el saldo, el uso y cada resolución.
¿Qué devuelve una resolución fallida?
Un status failed con un código de error. Las resoluciones fallidas no se cobran, así que puedes reintentar sin problema.
¿Cuánto puedo esperar un resultado?
El parámetro wait bloquea hasta 120 segundos. La mayoría de las resoluciones vuelven mucho antes; usa consultas periódicas si tu cliente no puede mantener una conexión tanto tiempo.
Guías útiles
¿Listo para construir?
Empieza con una prueba gratuita de 3 días y luego paga por cada resolución exitosa a medida que crece tu tráfico. No necesitas tarjeta para la prueba.