README.md

metadata

title: Turnstile Solver API
emoji: 🔓
colorFrom: red
colorTo: blue
sdk: docker
pinned: false
license: mit

Cloudflare Turnstile Solver API

这是一个基于 Python 的 Cloudflare Turnstile 验证码求解器 API 服务。

🚀 特性

• 多线程执行 - 同时解决多个验证码
• 多浏览器支持 - Chromium, Chrome, Edge 和 Camoufox
• 代理支持 - 使用 proxies.txt 文件中的代理
• REST API - 易于与其他应用程序集成
• 健康检查 - 提供 /health 和 /ready 端点

📡 API 使用方法

健康检查

GET /health

返回服务健康状态

就绪检查

GET /ready

检查浏览器池是否已初始化完成

求解 Turnstile

GET /turnstile?url=https://example.com&sitekey=0x4AAAAAAA

请求参数:

参数	类型	描述	必需
url	string	包含验证码的目标 URL	是
sitekey	string	验证码的 site key	是
action	string	验证码触发的动作	否
cdata	string	自定义数据	否

响应:

{
  "errorId": 0,
  "taskId": "d2cbb257-9c37-4f9c-9bc7-1eaee72d96a8"
}

获取结果

GET /result?id=f0dbe75b-fa76-41ad-89aa-4d3a392040af

响应 (成功):

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "token": "0.KBtT-r..."
  }
}

响应 (处理中):

{
  "status": "processing"
}

⚠️ 注意事项

• 服务启动后需要等待浏览器池初始化（约 30-60 秒）
• 在浏览器池就绪前，请求会返回 503 错误
• 可以通过 /ready 端点检查服务是否就绪

📞 联系方式

• 📢 频道: https://t.me/D3_vin
• 💬 聊天: https://t.me/D3vin_chat
• 📁 GitHub: https://github.com/D3-vin

📄 许可证

本项目仅供教育用途。使用风险自负。