UNLOCK API
Cloudflare Turnstile

Cloudflare Turnstile

Como enviar uma tarefa de Cloudflare Turnstile para a UNLOCK API com createTask ou in.php: nomes do tipo de tarefa, todos os parâmetros, o objeto solution, os campos de proxy e exemplos de código em 7 linguagens.
Preço
$0.55 $0.00055 por tarefa
Você envia
URL da página e site key, mais action e cData se o widget tiver
Você recebe
Token para cf-turnstile-response

Visão geral e preço

Nomes do tipo de tarefa

Use o primeiro nome para resolver sem proxy. Use o segundo nome e adicione os campos de proxy para resolver pelo seu próprio proxy. O preço é o mesmo.
TurnstileTaskProxylessSem proxy
TurnstileTaskCom seu proxy

Também aceito: AntiTurnstileTaskProxyless

Objeto da tarefa

type
StringObrigatório
Nome do tipo de tarefa. Reconhecido com letras maiúsculas ou minúsculas. TurnstileTaskProxyless | TurnstileTask
websiteURL
StringObrigatório
Endereço completo da página onde o CAPTCHA aparece, começando com http:// ou https://.
websiteKey
StringObrigatório
A chave do site do widget CAPTCHA, encontrada no código-fonte da página (por exemplo data-sitekey).
action
StringOpcional
Valor do parâmetro action do widget, se a página definir um.
data
StringOpcional
Valor do parâmetro cData do widget, se a página definir um.
pagedata
StringOpcional
Valor do parâmetro chlPageData, se a página definir um.
userAgent
StringOpcional
User-Agent do navegador a usar na resolução. Envie o mesmo quando enviar a resposta.

Campos que não aparecem aqui são repassados ao resolvedor como foram enviados.

Campos de proxy

Só para o nome de tipo com proxy. Envie os campos separados ou uma única string proxy.
proxyType
StringObrigatório
http, https, socks4 ou socks5.
proxyAddress
StringObrigatório
Endereço IP ou nome de host do proxy.
proxyPort
IntegerObrigatório
Porta do proxy.
proxyLogin
StringOpcional
Usuário do proxy, se o proxy exigir.
proxyPassword
StringOpcional
Senha do proxy, se o proxy exigir.
proxy
String
Todos os campos de proxy em uma única string, por exemplo http://user:pass@1.2.3.4:8080.

Usando proxy

Requisição

POST /createTask
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "TurnstileTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
  }
}

Objeto solution

Retornado em solution quando status é ready.
token
String
O token a enviar com o formulário da página.
userAgent
String
User-Agent usado na resolução. Use o mesmo quando enviar o 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
}

Exemplos 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 formulário in.php

A mesma tarefa com a requisição de formulário clássica. res.php retorna a resposta 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 formulário: in.php e res.php