Cloudflare Turnstile

Giải Cloudflare Turnstile — gửi sitekey + pageurl, nhận về token hợp lệ.

---

Các method hỗ trợ

Method	Mô tả	Proxy	Key hỗ trợ
turnstile_point	Giải Turnstile — tỷ lệ thành công cao hơn	Bắt buộc có auth	point
turnstile_max1	Giải Turnstile thông thường	Không cần	max1

---

1. Method turnstile_point

Dành cho point key. Bắt buộc kèm proxy có xác thực (user:pass).

API v1 — Gửi lên /in.php

Parameter	Giá trị	Mô tả
key bắt buộc	point_YOUR_API_KEY	API key
method bắt buộc	turnstile_point	Loại captcha
sitekey bắt buộc	Site key	Turnstile site key trên trang
pageurl bắt buộc	URL	Đường dẫn trang hiển thị Turnstile
proxy bắt buộc	http://user:pass@ip:port	Proxy có xác thực. Format: http://user:pass@ip:port hoặc scheme:ip:port:user:pass
useragent tuỳ chọn	String (tối đa 512 ký tự)	User-Agent tùy chỉnh. Phải bắt đầu bằng Mozilla/. Ví dụ: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/125.0.0.0 Safari/537.36. Không hợp lệ sẽ dùng mặc định.
json tuỳ chọn	1	Trả về JSON

Ví dụ Request

API v2

Parameter	Giá trị	Mô tả
type	TurnstileTokenTask	Task type
websiteURL	URL	Trang hiển thị Turnstile
websiteKey	Site key	Turnstile site key
proxy bắt buộc	http://user:pass@ip:port	Proxy có xác thực
useragent tuỳ chọn	String (tối đa 512 ký tự)	User-Agent tùy chỉnh. Phải bắt đầu bằng Mozilla/. Không hợp lệ sẽ dùng mặc định.

{
    "clientKey": "point_YOUR_API_KEY",
    "task": {
        "type": "TurnstileTokenTask",
        "websiteURL": "https://example.com/page",
        "websiteKey": "0x4AAAAAAAB4ydWk-tBU5CNJ",
        "proxy": "http://user:pass@ip:port",
        "useragent": "Mozilla/5.0 ..."
    }
}

---

2. Method turnstile_max1

Dành cho max1 key. Không cần proxy.

API v1 — Gửi lên /in.php

Parameter	Giá trị	Mô tả
key bắt buộc	max1_YOUR_API_KEY	API key
method bắt buộc	turnstile_max1	Loại captcha
sitekey bắt buộc	Site key	Turnstile site key trên trang
pageurl bắt buộc	URL	Đường dẫn trang hiển thị Turnstile
json tuỳ chọn	1	Trả về JSON

Ví dụ Request

API v2

Task type	Mô tả
TurnstileTaskProxyless	Không dùng proxy
TurnstileTask	Có proxy

{
    "clientKey": "max1_YOUR_API_KEY",
    "task": {
        "type": "TurnstileTaskProxyless",
        "websiteURL": "https://example.com/page",
        "websiteKey": "0x4AAAAAAAB4ydWk-tBU5CNJ"
    }
}

---

Lấy kết quả

API v1 — /res.php

API v2 — /v2/getTaskResult

{
    "errorId": 0,
    "status": "ready",
    "solution": {
        "token": "0.abc123def456..."
    }
}

Token dùng để submit form trên trang có Turnstile

---

Tham khảo thêm: API v1 Docs | API v2 Docs