UNLOCK API
Cloudflare Turnstile

Cloudflare Turnstile

Cómo enviar una tarea de Cloudflare Turnstile 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
$0.55 $0.00055 por tarea
Envías
URL de la página y site key, además de action y cData si el widget los tiene
Recibes
Token para cf-turnstile-response

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.
TurnstileTaskProxylessSin proxy
TurnstileTaskCon tu proxy

También se acepta: AntiTurnstileTaskProxyless

Objeto de tarea

type
StringObligatorio
Nombre del tipo de tarea. Se reconoce sin importar mayúsculas o minúsculas. TurnstileTaskProxyless | TurnstileTask
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).
action
StringOpcional
Valor del parámetro action del widget, si la página lo define.
data
StringOpcional
Valor del parámetro cData del widget, si la página lo define.
pagedata
StringOpcional
Valor del parámetro chlPageData, si la página lo define.
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": "TurnstileTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
  }
}

Objeto solution

Se devuelve en solution cuando status es ready.
token
String
El token que hay que enviar con el formulario de la página.
userAgent
String
User-Agent usado al resolver. Usa el mismo cuando envíes el token.
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "token": "0.zrSnRHO7h0HwSjSCU8oyzbjEtD8p...",
    "userAgent": "Mozilla/5.0 ..."
  },
  "cost": "0.00055",
  "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": "TurnstileTaskProxyless",
      "websiteURL": "https://example.com/login",
      "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
    }
}).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"]["token"])
        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=turnstile&sitekey=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