API Dokümantasyonu
Üç uç nokta, altı dilde eksiksiz kod örnekleri. Capzy'nin yüksek performanslı çözücü kümesiyle 60 saniyeden kısa sürede entegre olun.
Hızlı Başlangıç
POST /createTaskCaptcha türünü + site parametrelerini gönderin. Anında bir taskId alın.
POST /getTaskResultDurum ready olana kadar ~1 sn aralıklarla sorgulayın. Token, solution nesnesinde gelir.
POST /getBalanceKalan kredileri kontrol edin. Başarısız çözümler buraya otomatik iade edilir.
https://api.capzy.aiistek gövdesindeki clientKey ile kimlik doğrulamaUç Noktalar
/createTaskYeni bir captcha çözme görevi oluştur{
"clientKey": "capzy_...",
"task": {
"type": "AntiTurnstileTaskProxyLess",
"websiteURL": "https://example.com",
"websiteKey": "0x4AAA..."
}
}{
"errorId": 0,
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca",
"status": "processing"
}/getTaskResultGörev sonucunu sorgula{
"clientKey": "capzy_...",
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca"
}{
"errorId": 0,
"status": "ready",
"solution": {
"token": "0.eyJhbGci..."
}
}/getBalanceHesap bakiyesini kontrol et{ "clientKey": "capzy_..." }{ "errorId": 0, "balance": 9.50 }/reportScoreİsteğe bağlı: V3 görevleri için Google'ın doğruladığı skoru geri bildirin. Panelinizdeki V3 kalite görünümünü besler. Görev başına bir rapor; raporlar çözüm tamamlandıktan sonraki 24 saat içinde ulaşmalıdır.{
"clientKey": "capzy_...",
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca",
"score": 0.9,
"action": "login",
"hostname": "example.com"
}{ "errorId": 0 }/reportCorrectCaptchaİsteğe bağlı: çözümün hedef site tarafından KABUL EDİLDİĞİNİ bize bildirin. Özellikle bir konum döndürdüğümüz ve sürüklemeyi kendi tarayıcınızın yaptığı koordinat döndüren türler (ör. Shopee slider) için kullanışlıdır. Bu rapor, gerçek dünyadaki doğruluğa dair tek sinyalimizdir. Görev başına bir rapor, 24 saat içinde; fiyatlandırmayı asla etkilemez.{
"clientKey": "capzy_...",
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca"
}{ "errorId": 0 }/reportIncorrectCaptchaİsteğe bağlı: çözümün hedef site tarafından REDDEDİLDİĞİNİ bize bildirin. /reportCorrectCaptcha ile aynı gerçek dünya doğruluk takibini besler. Görev başına bir rapor, 24 saat içinde; fiyatlandırmayı asla etkilemez.{
"clientKey": "capzy_...",
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca"
}{ "errorId": 0 }Desteklenen Görev Türleri
Yükleniyor…Şu anda etkin görev türlerinin captcha sağlayıcısına göre gruplanmış canlı listesi. Fiyatlandırma ve ortalama çözüm süresi küme telemetrisinden otomatik güncellenir.
Hız Limitleri
Limitler, sahip olduğunuz tüm API anahtarları genelinde toplanarak hesap başına uygulanır. Limiti aşmak kredi tüketmeden bir hata kodu döndürür.
Her yeni hesap buradan başlar
Beklenen hacminizle bir destek talebi açın (ayrı bir fiyat kademesi yok, çözüm başına ücret aynı)
eşzamanlı görevlerÇözüm kuyruğunda aynı anda kaç göreviniz olabileceği. Bir görev createTask çağrısından tamamlanana kadar (başarı, başarısızlık veya zaman aşımı) limitinize sayılır.
hız limitiSaniyede kaç createTask çağrısı yapabileceğiniz. Kayan pencere, hesap başına uygulanır. Hızı aşmak kredi düşülmeden ERROR_RATE_LIMITED döndürür.
Hata Kodları
/createTask / /getTaskResult tarafından döndürülen her hata ve çözümü. Başarısız çözümler otomatik iade edilir: krediler anında bakiyenize geri döner.
Kimlik Doğrulama
API anahtarınız veya IP'nizle ilgili sorunlar.- #
ERROR_KEY_DOES_NOT_EXISTAPI anahtarınız tanınmadı.
çözümPanel → API Anahtarları bölümündeki değeri tekrar kontrol edin. Anahtarlar `capzy_` ile başlar. Yenilenen anahtarlar anında geçersiz olur.
- #
ERROR_IP_NOT_ALLOWEDİstek IP'niz API anahtarının izin listesinde değil.
çözümIP'nizi Panel → API Anahtarları bölümünden anahtarın izin listesine ekleyin veya IP sabitlemeye ihtiyacınız yoksa izin listesini tamamen kaldırın.
- #
ERROR_IP_BLOCKEDÇok fazla geçersiz istek gönderdiğiniz için IP'niz geçici olarak yasaklandı.
çözüm10 dakikada 100'den fazla geçersiz istek gönderen IP'leri (artan sürelerle) yasaklarız. Geçersiz isteklere neden olan hatayı düzeltin, ardından bekleyin. Yasaklar kademeye bağlı olarak 1 dakika ile 24 saat arasında otomatik olarak kalkar.
Doğrulama
Hatalı görev parametreleri veya sitekey için yanlış tür.- #
ERROR_INVALID_PARAMSİstek gövdesi hatalı biçimlendirilmiş veya zorunlu alanlar eksik.
çözüm`clientKey` değerinin en üst düzeyde olduğunu ve `task` içinde `type` ile birlikte zorunlu tanımlayıcının (websiteURL/websiteKey/captchaId vb.) bulunduğunu kontrol edin. Türe göre zorunlu parametreler için Görev Türleri bölümüne bakın.
- #
ERROR_BAD_SITEKEY`websiteKey`, tanımlayabildiğimiz hiçbir captcha sağlayıcısında kayıtlı değil.
çözümSitekey'i hedef sayfadan eksiksiz kopyaladığınızdan emin olun (`data-sitekey`, `sitekey:` veya `grecaptcha.render` / `hcaptcha.render` içindeki parametreye bakın).
- #
ERROR_TASK_NOT_SUPPORTEDGönderdiğiniz görev `type` değeri, Capzy'nin şu anda desteklediği bir captcha türü değil.
çözümEtkin türlerin tam listesi için aşağıdaki Görev Türleri bölümüne bakın. Listede olmayan bir captcha'ya ihtiyacınız varsa bir talep açın, önceliklendirelim.
- #
ERROR_WRONG_TASK_TYPEGörev türü, sitekey'in gerçek sağlayıcısıyla eşleşmiyor.
çözümSitekey'leri gerçek sağlayıcılarına karşı önceden kontrol ederiz. Hata yanıtı bir `recommended` alanı içerir: o görev türüne geçin. (Kredi düşülmez.)
- #
ERROR_PROXY_REQUIREDBu captcha IP'ye bağlıdır: token'ları onları çözen IP'ye bağlıdır.
çözüm`*TaskProxyLess` yerine `*Task` varyantına geçin ve token'ı göndereceğiniz IP ile eşleşen `proxyAddress` değerini iletin. Etkilenenler: Cloudflare Challenge, CaptchaFox, AWS WAF, DataDome, PerimeterX, Kasada, Akamai, Imperva.
- #
ERROR_NO_PROXYBu görev türü için proxy alanları zorunlu ancak eksik.
çözümGörev gövdenize `proxyType`, `proxyAddress`, `proxyPort` (ve isteğe bağlı olarak `proxyLogin`/`proxyPassword`/`userAgent`) ekleyin.
- #
ERROR_PROXY_CONNECT_REFUSEDSağladığınız proxy bağlantıyı reddetti.
çözümProxy kimlik bilgilerini, host erişilebilirliğini ve IP'nin aktif olduğunu kontrol edin. Sağlayıcı sorunlarını ayırt etmek için önce aynı proxy'yi kendi makinenizden deneyin.
Hız Limitleri
Eşzamanlı / saniye başına / iade oranı sınırları.- #
ERROR_MAX_TASKS_REACHEDHesap kademeniz için eşzamanlı görev sınırına ulaştınız.
çözümDaha fazla göndermeden önce işlemdeki görevlerin bitmesini bekleyin. Varsayılan Standart kademe 30 eşzamanlı görevdir; yükseltmek için destekle iletişime geçin.
- #
ERROR_RATE_LIMITED/createTask isteklerini hız limitinizden daha hızlı gönderiyorsunuz.
çözümYavaşlayın ve yeniden deneyin. Varsayılan Standart kademe kayan pencerede 30 istek/sn'dir. Hız limitini aşmak kredi tüketmez.
- #
ERROR_NO_SLOT_AVAILABLEKüme kapasitesi geçici olarak dolu.
çözümBirkaç saniye sonra yeniden deneyin (bu geçicidir). Dakikalarca sürerse status.capzy.ai adresini kontrol edin.
- #
ERROR_SYSTEM_MAINTENANCECapzy planlı bakımda.
çözümBakım süresinden sonra yeniden deneyin. Önceden duyuruları durum sayfasında yayınlarız.
Çözüm Sonuçları
Çözücünün döndürdüğü sonuç. Başarısız çözümler otomatik iade edilir.- #
ERROR_TIMEOUTGörev, türe özgü zaman aşımı sınırı içinde tamamlanmadı.
çözümOtomatik iade edildi, ücret alınmadı. Çoğu zaman aşımı geçicidir. Belirli bir captcha sürekli zaman aşımına uğruyorsa görev UUID'siyle bir talep açın.
- #
ERROR_CAPTCHA_UNSOLVABLEÇözücü bu sınamada yeniden deneme hakkını tüketti.
çözümOtomatik iade edildi, ücret alınmadı. Yaygın nedenler: eski sitekey, websiteURL'nin gömülü olduğu alan adıyla eşleşmemesi, captcha'nın hedef site tarafından devre dışı bırakılması.
- #
ERROR_NULL_RESULTÇözücü tamamlandı ancak token döndürmedi.
çözümOtomatik iade edildi. Genellikle hedef sitenin çözüm sırasında captcha'yı kaldırdığını gösterir. Yeniden deneyin; devam ederse bir talep açın.
- #
ERROR_INTERNALÇözüm hattında beklenmeyen hata.
çözümOtomatik iade edildi. Yeniden deneyin (bunlar nadirdir). Sık sık tekrarlanıyorsa görev UUID'siyle bir talep açın.
- #
ERROR_ZERO_BALANCEHesap bakiyesi görev maliyetini karşılamak için çok düşük.
çözümPanel → Faturalandırma bölümünden kredi ekleyin. Başarısız çözümler otomatik iade edilir, böylece yalnızca başarılı token'lar için ödersiniz.
Skor Raporlama
/reportScore'a özgü hatalar (V3 kalite geri bildirimi).- #
ERROR_TASK_NOT_FOUND/reportScore: taskId hesabınıza ait değil veya temizlenmiş.
çözümSkor raporları size ait bir göreve referans vermeli ve çözüm tamamlandıktan sonraki 24 saat içinde gönderilmelidir.
- #
ERROR_TASK_NOT_READY/reportScore: görev hâlâ işleniyor veya zaten başarısız oldu.
çözümYalnızca `ready` durumundaki görevler puanlanabilir. Raporlamadan önce /getTaskResult'ın ready döndürmesini bekleyin.
- #
ERROR_REPORT_TOO_LATE/reportScore: çözüm tamamlandıktan sonra 24 saatten fazla geçti.
çözümSkorları siteverify çağrınızdan birkaç dakika sonra raporlayın. Veriler V3 kalite panelimiz için en çok o zaman işe yarar.
Kod Test Alanı
Tüm önemli dillerde eksiksiz çalışan örnekler. Kopyalayın, API anahtarınızı yapıştırın, çalıştırın.
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)Kaynaklar
60 saniyeden kısa sürede entegre olun.
Kayıtta $0.10 ücretsiz kredi. Kredi kartı gerekmez.
Ücretsiz API anahtarınızı alın →