Cloudflare Turnstile 识别 API

概览

每 1,000 次价格

$0.55 (每个任务 $0.00055)

createTask 类型

TurnstileTaskProxyless, TurnstileTask

in.php 方法

turnstile

你发送

页面网址和 site key，如果组件有 action 和 cData 也一并发送

你得到

用于 cf-turnstile-response 的令牌

在哪里找到这些值

site key 在 Turnstile 元素的 data-sitekey 中。如果组件设置了 data-action 或 data-cdata，请作为 action 和 data 发送。

createTask 和 getTaskResult

创建任务，等待约 5 秒，然后每 5 秒查询一次结果，直到状态为 ready。如果任务失败，API 会返回错误，费用退回余额。

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"])

while True:
    time.sleep(5)
    r = requests.post(f"{API}/getTaskResult", json={"clientKey": KEY, "taskId": task["taskId"]}).json()
    if r["errorId"]:
        raise SystemExit(r["errorCode"])   # failed tasks are refunded
    if r["status"] == "ready":
        print(r["solution"]["token"])
        break

in.php 和 res.php

使用经典表单 API 发送同样的任务。加上 json=1 可获得 JSON 回复；不加则回复纯文本，例如 OK|1001。

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"}