| | ---
|
| | 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 | 自定义数据 | 否 |
|
| |
|
| | **响应:**
|
| |
|
| | ```json
|
| | {
|
| | "errorId": 0,
|
| | "taskId": "d2cbb257-9c37-4f9c-9bc7-1eaee72d96a8"
|
| | }
|
| | ```
|
| |
|
| | ### 获取结果
|
| | ```
|
| | GET /result?id=f0dbe75b-fa76-41ad-89aa-4d3a392040af
|
| | ```
|
| |
|
| | **响应 (成功):**
|
| |
|
| | ```json
|
| | {
|
| | "errorId": 0,
|
| | "status": "ready",
|
| | "solution": {
|
| | "token": "0.KBtT-r..."
|
| | }
|
| | }
|
| | ```
|
| |
|
| | **响应 (处理中):**
|
| |
|
| | ```json
|
| | {
|
| | "status": "processing"
|
| | }
|
| | ```
|
| |
|
| | ## ⚠️ 注意事项
|
| |
|
| | - 服务启动后需要等待浏览器池初始化（约 30-60 秒）
|
| | - 在浏览器池就绪前，请求会返回 503 错误
|
| | - 可以通过 `/ready` 端点检查服务是否就绪
|
| |
|
| | ## 📞 联系方式
|
| |
|
| | - 📢 **频道**: [https://t.me/D3_vin](https://t.me/D3_vin)
|
| | - 💬 **聊天**: [https://t.me/D3vin_chat](https://t.me/D3vin_chat)
|
| | - 📁 **GitHub**: [https://github.com/D3-vin](https://github.com/D3-vin)
|
| |
|
| | ## 📄 许可证
|
| |
|
| | 本项目仅供教育用途。使用风险自负。 |
