UNLOCK API
Capy Puzzle

Capy Puzzle

Cómo enviar una tarea de Capy Puzzle a UNLOCK API con createTask o in.php: nombres del tipo de tarea, todos los parámetros, el objeto solution, los campos de proxy y ejemplos de código en 7 lenguajes.
Precio
$1.495 $0.001495 por tarea
Envías
URL de la página y la site key de Capy
Recibes
Valores captchakey, challengekey y answer

Resumen y precio

Nombres del tipo de tarea

Usa el primer nombre para resolver sin proxy. Usa el segundo nombre y agrega los campos de proxy para resolver a través de tu propio proxy. El precio es el mismo.
CapyTaskProxylessSin proxy
CapyTaskCon tu proxy

Objeto de tarea

type
StringObligatorio
Nombre del tipo de tarea. Se reconoce sin importar mayúsculas o minúsculas. CapyTaskProxyless | CapyTask
websiteURL
StringObligatorio
Dirección completa de la página donde aparece el CAPTCHA, que empiece por http:// o https://.
websiteKey
StringObligatorio
La clave del sitio del widget CAPTCHA, que está en el código fuente de la página (por ejemplo data-sitekey).
apiServer
StringOpcional
Dirección del servidor de API que usa el widget, según el código fuente de la página.
userAgent
StringOpcional
User-Agent del navegador que se usará al resolver. Envía el mismo cuando envíes la respuesta.

Los campos que no aparecen aquí se pasan al resolvedor tal como se envían.

Campos de proxy

Solo para el nombre de tipo con proxy. Envía los campos por separado o una sola cadena proxy.
proxyType
StringObligatorio
http, https, socks4 o socks5.
proxyAddress
StringObligatorio
Dirección IP o nombre de host del proxy.
proxyPort
IntegerObligatorio
Puerto del proxy.
proxyLogin
StringOpcional
Usuario del proxy, si el proxy lo requiere.
proxyPassword
StringOpcional
Contraseña del proxy, si el proxy la requiere.
proxy
String
Todos los campos de proxy en una sola cadena, por ejemplo http://user:pass@1.2.3.4:8080.

Uso de proxy

Solicitud

POST /createTask
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "CapyTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"
  }
}

Objeto solution

Se devuelve en solution cuando status es ready.
captchakey
String
captcha key de Capy que hay que enviar.
challengekey
String
challenge key de Capy que hay que enviar.
answer
String
La respuesta que hay que enviar.
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "captchakey": "PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v",
    "challengekey": "Pt3dqiJ8Kq6mRzqT1R5cJ1jJm2m6m9eP",
    "answer": "0xax8ex0xax84x0xkx7qx0xux7qx0x..."
  },
  "cost": "0.001495",
  "createTime": 1791640000,
  "endTime": 1791640014,
  "solveCount": 1
}

Ejemplos de código

import time, requests

API = "https://unlock-api.com"
KEY = "YOUR_API_KEY"

task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
      "type": "CapyTaskProxyless",
      "websiteURL": "https://example.com/login",
      "websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"
    }
}).json()
if task["errorId"]:
    raise SystemExit(task["errorCode"])

for _ in range(60):   # 60 x 5 s = the 5 minute task limit
    time.sleep(5)
    r = requests.post(f"{API}/getTaskResult", json={"clientKey": KEY, "taskId": task["taskId"]}).json()
    if r["errorId"]:
        raise SystemExit(f"{r['errorCode']}: {r.get('errorDescription', '')}")   # failed tasks are refunded
    if r["status"] == "ready":
        print(r["solution"])
        break
else:
    raise SystemExit("timed out")

Método de formulario in.php

La misma tarea con la solicitud de formulario clásica. res.php devuelve la respuesta como texto.
in.php, res.php
curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=capy&captchakey=SITE_KEY&pageurl=https://example.com/login&json=1"
# {"status":1,"request":"1001"}

curl -s "https://unlock-api.com/res.php?key=YOUR_API_KEY&action=get&id=1001&json=1"
# {"status":0,"request":"CAPCHA_NOT_READY"}  then  {"status":1,"request":"ANSWER"}

API de formulario: in.php y res.php