README.md

---
title: Cloudflare Turnstile Solver API
emoji: 🔓
colorFrom: gray
colorTo: blue
sdk: docker
pinned: false
---

# 🔓 Cloudflare Turnstile Solver API

Self-hosted API pengganti layanan Turnstile eksternal. Menggunakan `puppeteer-real-browser` untuk solve Turnstile secara otomatis.

## Endpoint

### `GET /bypass/turnstile-min`

| Parameter | Wajib | Deskripsi |
|-----------|-------|-----------|
| `url` | ✅ | URL target yang memiliki Turnstile |
| `siteKey` | ❌ | Sitekey Turnstile (pakai mode page kalau kosong) |
| `apikey` | ❌ | API key (sesuai env `API_KEY` jika dikonfigurasi) |

**Response sukses:**
```json
{
  "status": true,
  "creator": "XAi Community",
  "token": "0.eyJhbGci...",
  "time": 4.231
}
```

**Response gagal:**
```json
{
  "status": false,
  "message": "Pesan error"
}
```

### `GET /`
Health check — cek status solver dan daftar endpoint.

## Penggunaan di Bot

```js
const apiUrl = global.API(
    'theresav',
    '/bypass/turnstile-min',
    {
        url: 'https://izen.lol',
        siteKey: '0x4AAAAAADNEi_2N24gpQqY0'
    },
    'apikey'
);
```

Atau langsung ke Space ini:

```
https://kavion-cf.hf.space/bypass/turnstile-min?url=https://izen.lol&siteKey=0x4AAAAAADNEi_2N24gpQqY0
```

## Environment Variables

| Variabel | Deskripsi |
|----------|-----------|
| `API_KEY` | (Opsional) Kunci proteksi endpoint. Kosongkan jika publik. |
| `PORT` | Port server (default: 7860) |

## Disclaimer

Dibuat untuk keperluan edukasi dan testing. MIT License — XAi Community.