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

## 📄 许可证

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