Cloudflare Turnstile 풀이 API

한눈에 보기

1,000건당 가격

$0.55 (1건당 $0.00055)

createTask 이름

TurnstileTaskProxyless, TurnstileTask

in.php 방식

turnstile

보내는 것

페이지 주소와 사이트 키, 위젯에 있으면 action과 cData

받는 것

cf-turnstile-response에 넣을 토큰

값을 찾는 곳

사이트 키는 Turnstile 요소의 data-sitekey에 있어요. 위젯에 data-action이나 data-cdata가 있으면 action과 data로 보내세요.

createTask와 getTaskResult

작업을 만들고 5초쯤 기다린 뒤, 상태가 ready가 될 때까지 5초마다 결과를 확인하세요. 작업이 실패하면 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"}