Troubleshooting

CAPTCHA Çözme Oranı Düşüşleri: Performans Regresyon Teşhisi

CAPTCHA çözme oranınız bir gecede %95'ten %60'a düştü. Destek ekibiyle iletişime geçmeden önce bu kılavuz, kodunuz, proxy'niz, hedef siteniz veya CaptchaAI hizmetiniz olsun, temel nedeni belirlemek için yapılandırılmış bir teşhis üzerinden yürür.

Tanısal Karar Ağacı

Solve rate dropped
├── Is the API returning errors? → Check error codes
│   ├── ERROR_WRONG_USER_KEY → API key issue
│   ├── ERROR_ZERO_BALANCE → Balance depleted
│   ├── ERROR_NO_SLOT_AVAILABLE → Rate limiting
│   └── ERROR_CAPTCHA_UNSOLVABLE → CAPTCHA changed
├── Are tokens returned but rejected by the target site?
│   ├── Token expired before submission → Speed up injection
│   ├── Sitekey changed → Re-extract from page
│   └── Domain mismatch → Check pageurl parameter
├── Are proxies failing?
│   ├── Proxy banned by target → Rotate proxies
│   └── Proxy timeout → Check proxy health
└── Did the target site change?
    ├── New CAPTCHA type → Update method parameter
    ├── JavaScript changes → Re-analyze page
    └── Rate limiting by site → Reduce frequency

Adım 1: CaptchaAI Hata Kodlarını Kontrol Edin

Hızlı bir teşhis komut dosyası çalıştırın:

# diagnose_solve_rate.py
import os
import requests
from collections import Counter

API_KEY = os.environ.get("CAPTCHAAI_KEY", "YOUR_API_KEY")

def check_balance():
    """Verify API key and balance."""
    resp = requests.get("https://ocr.captchaai.com/res.php", params={
        "key": API_KEY, "action": "getbalance", "json": "1",
    })
    result = resp.json()
    print(f"Balance: {result}")
    return result

def test_solve(sitekey, pageurl, runs=5):
    """Run test solves and collect error statistics."""
    errors = Counter()
    successes = 0

    for i in range(runs):
        # Submit
        resp = requests.get("https://ocr.captchaai.com/in.php", params={
            "key": API_KEY,
            "method": "userrecaptcha",
            "googlekey": sitekey,
            "pageurl": pageurl,
            "json": "1",
        })
        result = resp.json()

        if result.get("status") != 1:
            errors[result.get("request", "UNKNOWN")] += 1
            print(f"  Run {i+1}: Submit error: {result.get('request')}")
            continue

        task_id = result["request"]
        import time
        time.sleep(15)

        # Poll
        for _ in range(25):
            poll = requests.get("https://ocr.captchaai.com/res.php", params={
                "key": API_KEY, "action": "get",
                "id": task_id, "json": "1",
            })
            poll_result = poll.json()

            if poll_result.get("status") == 1:
                successes += 1
                print(f"  Run {i+1}: Solved")
                break
            if poll_result.get("request") != "CAPCHA_NOT_READY":
                errors[poll_result.get("request", "UNKNOWN")] += 1
                print(f"  Run {i+1}: Error: {poll_result.get('request')}")
                break
            time.sleep(5)
        else:
            errors["TIMEOUT"] += 1
            print(f"  Run {i+1}: Timeout")

    print(f"\nResults: {successes}/{runs} solved")
    if errors:
        print(f"Errors: {dict(errors)}")

# Run diagnostics
print("=== Balance Check ===")
check_balance()

print("\n=== Test Solves ===")
test_solve("YOUR_SITEKEY", "https://your-staging.example.com", runs=5)

Adım 2: Hedef Site Parametrelerini Doğrulayın

Çözüm oranındaki düşüşlerin en yaygın nedeni değişen site anahtarı veya sayfa yapısıdır.

Site anahtarının değişip değişmediğini kontrol edin

Hedef sayfayı ziyaret edin, Geliştirici Araçları'nı (F12) açın ve şunu arayın:

  • reCAPTCHA: data-sitekey veya grecaptcha.render çağrısı
  • Cloudflare Turnstile: Turnstile widget'ındaki data-sitekey
  • GeeTest: GeeTest'in başlatılmasındaki gt parametresi

Kodunuzdaki site anahtarıyla karşılaştırın. Değiştirilen tek bir karakter %100 başarısızlığa neden olur.

CAPTCHA türünün değişip değişmediğini kontrol edin

Bazı siteler CAPTCHA sağlayıcıları arasında geçiş yapar:

  • reCAPTCHA v2 → reCAPTCHA v3 (görünmez)
  • reCAPTCHA → Cloudflare Turnstile
  • Resim CAPTCHA → reCAPTCHA Enterprise

Tür değiştiyse method parametrenizi buna göre güncelleyin.

3. Adım: Proxy Sağlığını Değerlendirin

Proxy kalitesi, özellikle CaptchaAI'nin proxy'nizi kullandığı belirteç tabanlı CAPTCHA'lar için çözüm oranlarını doğrudan etkiler.

Proxy Sorunu Belirti Düzeltme
Proxy hedef tarafından yasaklandı Jeton çözüldü ancak reddedildi Yeni konut vekillerine geçiş yapın
Proxy döndürme hataları ERROR_PROXY_NOT_FOUND Proxy'nin canlı ve erişilebilir olduğunu doğrulayın
Veri merkezi proxy'si algılandı Daha düşük çözüm oranları Kendi sunucu altyapınız'lerine geçiş yapın
Proxy coğrafi uyumsuzluğu Tutarsız sonuçlar Proxy ülkesini hedef siteyle eşleştirin

Sorunun proxy olup olmadığını yalıtmak için önce proxy olmadan test edin (CAPTCHA türü proxy'siz çözmeyi destekliyorsa).

4. Adım: Token Zamanlamasını Kontrol Edin

CAPTCHA belirteçlerinin geçerliliği sınırlıdır:

CAPTCHA Türü Token Ömrü
reCAPTCHA v2 ~120 saniye
reCAPTCHA v3 ~120 saniye
Cloudflare Turnstile ~300 saniye
GeeTest v3 ~60 saniye

İşlem hattınızın jetonu alıp forma eklemesi arasında çok uzun zaman geçerse jetonun süresi dolar ve site onu reddeder.

Düzeltme: getTaskResult ile form gönderimi arasındaki süreyi ölçün. 60 saniyeden uzunsa ardışık düzeninizi optimize edin.

Adım 5: Hata Dağıtımını Analiz Edin

Temel nedenini bulmak için hatalarınızı sıklığa göre sıralayın:

Hata Anlamı Eylem
ERROR_CAPTCHA_UNSOLVABLE CAPTCHA çok karmaşık veya değiştirilmiş CaptchaAI'ye rapor verin; site anahtarının doğru olup olmadığını kontrol edin
ERROR_WRONG_CAPTCHA_ID Yanlış görev kimliğini yoklama Kodunuzda görev kimliği izlemeyi düzeltin
ERROR_ZERO_BALANCE Kredi bitti Bakiyeyi tamamla
ERROR_NO_SLOT_AVAILABLE Hız sınırlı Eşzamanlılığı azaltın veya gecikme ekleyin
CAPCHA_NOT_READY (zaman aşımı) Çözüm çok uzun sürüyor Anket zaman aşımını artırın; site anahtarının geçerli olup olmadığını kontrol edin

Adım 6: Temel Çizgiyle Karşılaştırın

Karşılaştırmaları daha önce çalıştırdıysanız mevcut metrikleri temel değerlerinizle karşılaştırın:

Metrik Temel Mevcut Delta Endişe mi?
Çözme oranı %95 ? > %5 düşüş = araştırın
Medyan çözme süresi 15'ler ? > %50 artış = araştırın
Hata oranı %2 ? > %5 = araştır
Token kabul oranı %98 ? > %3 düşüş = site değişti

Desteğe Ne Zaman Başvurulmalı?

Aşağıdaki durumlarda CaptchaAI desteğine başvurun:

  • Tüm teşhis adımları başarılı ancak çözüm oranı düşük kalıyor
  • Daha önce çalışan site anahtarlarında ERROR_CAPTCHA_UNSOLVABLE oranı %20'yi aşıyor
  • Bakiye doğru görünüyor ancak çözümler hala başarısız
  • Sorun 2 saatten fazla sürüyor

Raporunuza şunları ekleyin:

  1. CAPTCHA türü ve site anahtarı
  2. Hedef site URL'si
  3. Hata dağıtımı (tanı komut dosyasından)
  4. Sorun başladığında
  5. Kodunuzda yaptığınız herhangi bir değişiklik

Sorun Giderme Hızlı Başvuru

Senaryo Büyük Olasılık Nedeni İlk Eylem
%100 arıza, tümü ERROR_WRONG_USER_KEY Geçersiz API anahtarı API anahtarını yeniden kontrol edin
Günler geçtikçe kademeli düşüş Proxy bozulması Proxy'leri döndür
%0'a ani düşüş Site anahtarı veya sayfa değiştirildi CAPTCHA parametrelerini yeniden çıkarın
Çözüldü ancak jetonlar site tarafından reddedildi Jeton süresinin dolması veya alan adı uyuşmazlığı Zamanlamayı ve pageurl'yi kontrol edin
Test sitesinde çalışıyor, hedefte başarısız oluyor Siteye özgü kısıtlamalar Siteler arasındaki parametreleri karşılaştırın

SSS

CaptchaAI'nin çözüm hızı belirli bir site için değişebilir mi?

Evet. Bir site CAPTCHA yapılandırmasını yükseltirse (ör. daha zorlu zorluklar, kurumsal özellikler), CaptchaAI'nin çözümleyicileri uyum sağlayana kadar çözüm oranları geçici olarak düşebilir.

Her ERROR_CAPTCHA_UNSOLVABLE'yi raporlamalı mıyım?

Hayır. Karmaşık CAPTCHA'lar için %2-5 oranında çözülemezlik oranı normaldir. Yalnızca oran sürekli olarak %15-20'yi aşarsa rapor verin.

Çözme oranlarının ne kadar çabuk iyileşmesini beklemeliyim?

Sorun CaptchaAI'den kaynaklanıyorsa kurtarma genellikle birkaç saat içinde gerçekleşir. Hedef site değiştiyse entegrasyon parametrelerinizi güncellemeniz gerekebilir.

İlgili Makaleler

Sonraki Adımlar

CAPTCHA boru hattınızı sağlıklı tutun —CaptchaAI API anahtarınızı alın.

İlgili kılavuzlar:

Bu makale için yorumlar devre dışı bırakılmıştır.

İlgili Yazılar

DevOps & Scaling Otomatik Ölçeklendirme CAPTCHA Çözme Çalışanları
Üretimdeki Captcha AI iş akışlarına yönelik mimari kararları, işletim hususlarını ve otomasyon modellerini içeren Otomatik Ölçeklendirme CAPTCHA Çözme Çalışanla...

Üretimdeki Captcha AI iş akışlarına yönelik mimari kararları, işletim hususlarını ve otomasyon modellerini içe...

Apr 21, 2026
Tutorials CAPTCHA Çözme İşlemi: Saatte 10.000 Görev Nasıl İşlenir?
CAPTCHA Çözme İşlemi için adım adım eğitim: Saatte 10.000 Görev Nasıl İşlenir?, doğrudan yeniden kullanılabilir örnekler ve net bir Captcha AI iş akışıyla.

CAPTCHA Çözme İşlemi için adım adım eğitim: Saatte 10.000 Görev Nasıl İşlenir?, doğrudan yeniden kullanılabili...

May 08, 2026
DevOps & Scaling CAPTCHA Çözme Altyapısı için Mavi-Yeşil Dağıtım
Üretimdeki Captcha AI iş akışlarına yönelik mimari kararları, işletim hususlarını ve otomasyon modellerini içeren CAPTCHA Çözme Altyapısı için Mavi-Yeşil Dağıtı...

Üretimdeki Captcha AI iş akışlarına yönelik mimari kararları, işletim hususlarını ve otomasyon modellerini içe...

Apr 27, 2026