Dokumentasi API
Tiga endpoint, contoh kode lengkap dalam enam bahasa. Integrasikan dalam waktu kurang dari 60 detik dengan cluster solver berperforma tinggi dari Capzy.
Quick Start
POST /createTaskKirim jenis captcha + parameter situs. Dapatkan taskId secara instan.
POST /getTaskResultPoll ~1 dtk hingga status ready. Token ada di objek solution.
POST /getBalancePeriksa sisa kredit. Solve yang gagal direfund otomatis di sini.
https://api.capzy.aiautentikasi melalui clientKey di body permintaanEndpoint
/createTaskBuat task solving captcha baru{
"clientKey": "capzy_...",
"task": {
"type": "AntiTurnstileTaskProxyLess",
"websiteURL": "https://example.com",
"websiteKey": "0x4AAA..."
}
}{
"errorId": 0,
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca",
"status": "processing"
}/getTaskResultPoll hasil task{
"clientKey": "capzy_...",
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca"
}{
"errorId": 0,
"status": "ready",
"solution": {
"token": "0.eyJhbGci..."
}
}/getBalancePeriksa saldo akun{ "clientKey": "capzy_..." }{ "errorId": 0, "balance": 9.50 }/reportScoreOpsional: laporkan kembali skor terverifikasi Google untuk task V3. Menjadi dasar tampilan kualitas V3 di dasbor Anda. Satu laporan per task; laporan harus masuk dalam 24 jam setelah solve selesai.{
"clientKey": "capzy_...",
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca",
"score": 0.9,
"action": "login",
"hostname": "example.com"
}{ "errorId": 0 }/reportCorrectCaptchaOpsional: beri tahu kami bahwa solve DITERIMA oleh situs target. Sangat berguna untuk jenis yang mengembalikan koordinat (mis. slider Shopee) di mana kami mengembalikan posisi dan browser Anda sendiri yang melakukan drag. Laporan ini adalah satu-satunya sinyal akurasi dunia nyata kami. Satu laporan per task, dalam 24 jam; tidak pernah memengaruhi harga.{
"clientKey": "capzy_...",
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca"
}{ "errorId": 0 }/reportIncorrectCaptchaOpsional: beri tahu kami bahwa solve DITOLAK oleh situs target. Mengisi pelacakan akurasi dunia nyata yang sama dengan /reportCorrectCaptcha. Satu laporan per task, dalam 24 jam; tidak pernah memengaruhi harga.{
"clientKey": "capzy_...",
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca"
}{ "errorId": 0 }Jenis Task yang Didukung
Memuat…Daftar langsung jenis task yang saat ini aktif, dikelompokkan berdasarkan penyedia captcha. Harga dan rata-rata waktu solve diperbarui otomatis dari telemetri cluster.
Rate Limit
Batas diberlakukan per akun, digabungkan dari semua API key yang Anda miliki. Melebihi batas mengembalikan kode error tanpa memakai kredit.
Setiap akun baru dimulai di sini
Buka tiket dukungan dengan perkiraan volume Anda (tanpa tier harga terpisah, tarif per solve sama)
task bersamaanBerapa banyak task yang dapat Anda miliki di antrean solve sekaligus. Sebuah task dihitung terhadap batas Anda sejak createTask hingga selesai (berhasil, gagal, atau timeout).
rate limitBerapa banyak panggilan createTask yang dapat Anda lakukan per detik. Sliding window, diberlakukan per akun. Melebihi rate mengembalikan ERROR_RATE_LIMITED tanpa kredit dipotong.
Kode Error
Setiap error yang dikembalikan oleh /createTask / /getTaskResult beserta solusinya. Solve yang gagal direfund otomatis: kredit langsung kembali ke saldo Anda.
Autentikasi
Masalah dengan API key atau IP Anda.- #
ERROR_KEY_DOES_NOT_EXISTAPI key Anda tidak dikenali.
solusiPeriksa kembali nilainya di Dasbor → API Key. Key diawali dengan `capzy_`. Key yang dirotasi langsung tidak berlaku.
- #
ERROR_IP_NOT_ALLOWEDIP permintaan Anda tidak ada di allowlist API key.
solusiTambahkan IP Anda ke allowlist key di Dasbor → API Key, atau hapus allowlist sepenuhnya jika Anda tidak memerlukan pembatasan IP.
- #
ERROR_IP_BLOCKEDIP Anda diblokir sementara karena mengirim terlalu banyak permintaan yang tidak valid.
solusiKami memblokir IP yang mengirim 100+ permintaan tidak valid dalam 10 menit (bertingkat). Perbaiki bug yang menyebabkan permintaan tidak valid, lalu tunggu. Blokir berakhir otomatis mulai dari 1 menit hingga 24 jam tergantung tier.
Validasi
Parameter task salah atau jenis yang salah untuk sitekey.- #
ERROR_INVALID_PARAMSBody permintaan tidak sesuai format atau tidak memiliki field wajib.
solusiPastikan `clientKey` berada di level teratas dan `task` berisi `type` beserta identifier wajib (websiteURL/websiteKey/captchaId/dll). Lihat bagian Jenis Task untuk parameter wajib per jenis.
- #
ERROR_BAD_SITEKEY`websiteKey` tidak terdaftar pada penyedia captcha mana pun yang dapat kami identifikasi.
solusiPastikan Anda menyalin sitekey lengkap dari halaman target (cari `data-sitekey`, `sitekey:`, atau parameter di `grecaptcha.render` / `hcaptcha.render`).
- #
ERROR_TASK_NOT_SUPPORTED`type` task yang Anda kirim bukan jenis captcha yang saat ini didukung Capzy.
solusiLihat bagian Jenis Task di bawah untuk daftar lengkap yang aktif. Jika Anda membutuhkan captcha yang tidak tercantum, buka tiket dan kami akan memprioritaskannya.
- #
ERROR_WRONG_TASK_TYPEJenis task tidak sesuai dengan penyedia sebenarnya dari sitekey tersebut.
solusiKami memeriksa sitekey terlebih dahulu terhadap penyedia sebenarnya. Respons error menyertakan field `recommended`: beralihlah ke jenis task tersebut. (Tidak ada kredit yang ditagih.)
- #
ERROR_PROXY_REQUIREDCaptcha ini terikat IP: tokennya terikat pada IP yang menyelesaikannya.
solusiBeralih ke varian `*Task` (alih-alih `*TaskProxyLess`) dan kirim `proxyAddress` yang sesuai dengan IP yang akan Anda gunakan untuk mengirim token. Berlaku untuk: Cloudflare Challenge, CaptchaFox, AWS WAF, DataDome, PerimeterX, Kasada, Akamai, Imperva.
- #
ERROR_NO_PROXYField proxy wajib untuk jenis task ini tetapi tidak disertakan.
solusiSertakan `proxyType`, `proxyAddress`, `proxyPort` (dan opsional `proxyLogin`/`proxyPassword`/`userAgent`) di body task Anda.
- #
ERROR_PROXY_CONNECT_REFUSEDProxy yang Anda berikan menolak koneksi.
solusiPeriksa kredensial proxy, keterjangkauan host, dan pastikan IP masih aktif. Coba proxy yang sama dari mesin Anda sendiri terlebih dahulu untuk mengisolasi masalah penyedia.
Rate Limit
Batas bersamaan / per detik / rasio refund.- #
ERROR_MAX_TASKS_REACHEDAnda telah mencapai batas task bersamaan untuk tier akun Anda.
solusiTunggu task yang sedang berjalan selesai sebelum mengirim lebih banyak. Tier Regular default adalah 30 bersamaan; hubungi dukungan untuk upgrade.
- #
ERROR_RATE_LIMITEDAnda mengirim /createTask lebih cepat dari rate limit Anda.
solusiPerlambat dan coba lagi. Tier Regular default adalah 30 req/dtk dengan sliding window. Melebihi rate tidak memakai kredit.
- #
ERROR_NO_SLOT_AVAILABLEKapasitas cluster sedang penuh untuk sementara.
solusiCoba lagi setelah beberapa detik (ini bersifat sementara). Jika berlanjut hingga beberapa menit, periksa status.capzy.ai.
- #
ERROR_SYSTEM_MAINTENANCECapzy sedang dalam pemeliharaan terjadwal.
solusiCoba lagi setelah jendela pemeliharaan. Kami memasang pemberitahuan di halaman status sebelumnya.
Hasil Solve
Apa yang dikembalikan solver. Solve yang gagal direfund otomatis.- #
ERROR_TIMEOUTTask tidak selesai dalam batas waktu per jenis.
solusiDirefund otomatis, tanpa biaya. Sebagian besar timeout bersifat sementara. Jika captcha tertentu terus-menerus timeout, buka tiket dengan UUID task.
- #
ERROR_CAPTCHA_UNSOLVABLESolver telah menghabiskan jatah retry pada challenge ini.
solusiDirefund otomatis, tanpa biaya. Penyebab umum: sitekey kedaluwarsa, websiteURL tidak sesuai dengan domain penyematan, captcha dinonaktifkan oleh situs target.
- #
ERROR_NULL_RESULTSolver selesai tetapi tidak mengembalikan token.
solusiDirefund otomatis. Biasanya menandakan situs target menghapus captcha di tengah solve. Coba lagi; jika berlanjut, buka tiket.
- #
ERROR_INTERNALError tak terduga di dalam pipeline solve.
solusiDirefund otomatis. Coba lagi (ini jarang terjadi). Jika Anda melihatnya berulang-ulang, buka tiket dengan UUID task.
- #
ERROR_ZERO_BALANCESaldo akun terlalu rendah untuk menutupi biaya task.
solusiTambahkan kredit dari Dasbor → Billing. Solve yang gagal direfund otomatis sehingga Anda hanya membayar token yang berhasil.
Pelaporan Skor
Error khusus untuk /reportScore (umpan balik kualitas V3).- #
ERROR_TASK_NOT_FOUND/reportScore: taskId bukan milik akun Anda atau sudah dihapus.
solusiLaporan skor harus merujuk ke task milik Anda dan harus dikirim dalam 24 jam setelah solve selesai.
- #
ERROR_TASK_NOT_READY/reportScore: task masih diproses atau sudah gagal.
solusiHanya task `ready` yang dapat diberi skor. Tunggu hingga /getTaskResult mengembalikan ready sebelum melapor.
- #
ERROR_REPORT_TOO_LATE/reportScore: lebih dari 24 jam telah berlalu sejak solve selesai.
solusiLaporkan skor dalam beberapa menit setelah panggilan siteverify Anda. Saat itulah data paling berguna untuk dasbor kualitas V3 kami.
Playground Kode
Contoh lengkap yang berfungsi dalam setiap bahasa utama. Salin, tempel API key Anda, jalankan.
import requests, time
API = "https://api.capzy.ai"
KEY = "capzy_your_key_here"
# Create task
task = requests.post(f"{API}/createTask", json={
"clientKey": KEY,
"task": {
"type": "AntiTurnstileTaskProxyLess",
"websiteURL": "https://example.com",
"websiteKey": "0x4AAA..."
}
}).json()
task_id = task["taskId"]
# Poll for result
while True:
result = requests.post(f"{API}/getTaskResult", json={
"clientKey": KEY,
"taskId": task_id
}).json()
if result["status"] == "ready":
token = result["solution"]["token"]
print(f"Solved: {token[:50]}...")
break
elif result["status"] == "failed":
print(f"Failed: {result.get('errorDescription')}")
break
time.sleep(1)Sumber Daya
Integrasikan dalam waktu kurang dari 60 detik.
Kredit gratis $0.10 saat mendaftar. Tidak perlu kartu kredit.
Dapatkan API key gratis Anda →