İçeriğe geç

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ıç

adım 1
POST /createTask

Captcha türünü + site parametrelerini gönderin. Anında bir taskId alın.

adım 2
POST /getTaskResult

Durum ready olana kadar ~1 sn aralıklarla sorgulayın. Token, solution nesnesinde gelir.

adım 3
POST /getBalance

Kalan kredileri kontrol edin. Başarısız çözümler buraya otomatik iade edilir.

temel urlhttps://api.capzy.aiistek gövdesindeki clientKey ile kimlik doğrulama

Uç Noktalar

POST/createTaskYeni bir captcha çözme görevi oluştur
istek
{
  "clientKey": "capzy_...",
  "task": {
    "type": "AntiTurnstileTaskProxyLess",
    "websiteURL": "https://example.com",
    "websiteKey": "0x4AAA..."
  }
}
yanıt
{
  "errorId": 0,
  "taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca",
  "status": "processing"
}
POST/getTaskResultGörev sonucunu sorgula
istek
{
  "clientKey": "capzy_...",
  "taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca"
}
yanıt
{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "token": "0.eyJhbGci..."
  }
}
POST/getBalanceHesap bakiyesini kontrol et
istek
{ "clientKey": "capzy_..." }
yanıt
{ "errorId": 0, "balance": 9.50 }
POST/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.
istek
{
  "clientKey": "capzy_...",
  "taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca",
  "score": 0.9,
  "action": "login",
  "hostname": "example.com"
}
yanıt
{ "errorId": 0 }
POST/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.
istek
{
  "clientKey": "capzy_...",
  "taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca"
}
yanıt
{ "errorId": 0 }
POST/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.
istek
{
  "clientKey": "capzy_...",
  "taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca"
}
yanıt
{ "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.

Görev türleri yükleniyor…

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.

Varsayılan
30 eşzamanlı · 30 istek/sn

Her yeni hesap buradan başlar

Daha yüksek eşzamanlılık
300+ eşzamanlı · 100+ istek/sn

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 limiti

Saniyede 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_EXIST

    API 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_SUPPORTED

    Gö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_TYPE

    Gö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_REQUIRED

    Bu 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_PROXY

    Bu 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_REFUSED

    Sağ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_REACHED

    Hesap 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_AVAILABLE

    Kü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_MAINTENANCE

    Capzy 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_TIMEOUT

    Gö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_BALANCE

    Hesap 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.

    #
06

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.

solve.py
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)
Çıktı ÖnizlemesiBaşarılı (200 OK)
{ "errorId": 0, "status": "ready", "solution": { "token": "0.eyJhbGci..." } }

60 saniyeden kısa sürede entegre olun.

Kayıtta $0.10 ücretsiz kredi. Kredi kartı gerekmez.

Ücretsiz API anahtarınızı alın →