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-sitekeyveyagrecaptcha.renderçağrısı - Cloudflare Turnstile: Turnstile widget'ındaki
data-sitekey - GeeTest: GeeTest'in başlatılmasındaki
gtparametresi
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_UNSOLVABLEoranı %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:
- CAPTCHA türü ve site anahtarı
- Hedef site URL'si
- Hata dağıtımı (tanı komut dosyasından)
- Sorun başladığında
- 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
- Captcha Çözme Oranı Sli Slo İzleme
- Zaman Serisi Captcha Çözümü Performans Trendleri
- Captcha Çözme Başarı Oranı Düşme Teşhisi
Sonraki Adımlar
CAPTCHA boru hattınızı sağlıklı tutun —CaptchaAI API anahtarınızı alın.
İlgili kılavuzlar: