Güvenli kapsam: Bu kılavuz yalnızca size ait veya yetkilendirilmiş QA, staging ve ön üretim ortamları için geçerlidir. İçerik kendi CAPTCHA entegrasyonlarınız için tanılama, test ve gözlemlenebilirlik kalıplarını ele alır — üçüncü taraf siteleri veya yetkisiz akışları kapsamaz.
CAPTCHA solver yanıt süresi; CAPTCHA türüne, bölgeye, yüke ve entegrasyona göre büyük ölçüde değişir. Bu kılavuz, kendi ortamınızda tutarlı bir ölçüm metodolojisi sağlar — hangi sağlayıcının evrensel olarak hızlı olduğuna dair iddia değil.
Benchmark neden kendi ortamınızda yapılmalı
Veri merkezinizden gelen ağ gecikmesi, belirli CAPTCHA türü ve yeniden deneme oranınız üretimde gördüğünüz süreleri etkiler. Genel benchmark'lar göstergedir — kendi ortamınızdaki sonuçlar farklı olabilir.
Ölçüm metodolojisi
Her CAPTCHA türü için kendi pipeline'ınızdan 200+ görev çalıştırın. Her görev için kaydedin: in.php gönderim zaman damgası, res.php'den ilk başarılı sorgulama zaman damgası ve toplam wallclock süresi. Medyan, P90 ve P99 hesaplayın.
Ölçüm tablosu şablonu
| CAPTCHA türü | Örnek | Medyan | P90 | P99 |
|---|---|---|---|---|
| reCAPTCHA v2 | 200 | doldurun | doldurun | doldurun |
| reCAPTCHA v3 | 200 | doldurun | doldurun | doldurun |
| Cloudflare Turnstile | 200 | doldurun | doldurun | doldurun |
| GeeTest v3 | 200 | doldurun | doldurun | doldurun |
| Image / OCR | 200 | doldurun | doldurun | doldurun |
Değerler ortamınız için gösterge niteliğindedir ve CAPTCHA türüne, bölgeye, yüke ve entegrasyona göre değişebilir; evrensel garanti olarak yorumlanmamalıdır.
Uyumluluk ve kapsam
Sağlayıcıları karşılaştırırken her sağlayıcının aynı CAPTCHA türünü ele aldığından emin olun. Elma elmaya karşılaştırın: reCAPTCHA v2 vs reCAPTCHA v2; image OCR vs Turnstile değil.
Kendi verilerinizle kapasite planlaması
Kendi dağılımınızı elde ettikten sonra sürdürülebilir kapasiteyi hesaplayın: görev/dakika = 60 / medyan_saniye * worker. Sıçramalar için %30 buffer ekleyin.
Benchmark script
import os, time, statistics, requests
API_KEY = os.environ['CAPTCHAAI_API_KEY']
SAMPLES = 200
def submit_recaptcha_v2(sitekey, pageurl):
r = requests.post('https://ocr.captchaai.com/in.php', data={
'key': API_KEY, 'method': 'userrecaptcha',
'googlekey': sitekey, 'pageurl': pageurl, 'json': 1,
}).json()
return r['request']
def wait(task_id):
t0 = time.time()
while True:
time.sleep(5)
rr = requests.get('https://ocr.captchaai.com/res.php', params={
'key': API_KEY, 'action': 'get', 'id': task_id, 'json': 1,
}).json()
if rr['status'] == 1:
return time.time() - t0
times = [wait(submit_recaptcha_v2(SITE, PAGE)) for _ in range(SAMPLES)]
print('medyan', statistics.median(times))
print('p90', statistics.quantiles(times, n=10)[8])
print('p99', statistics.quantiles(times, n=100)[98])
SSS
Evrensel olarak hızlı bir solver var mı? Hayır. Sonuçlar bölgeye, türe, yüke ve entegrasyona göre değişir.
yüksek doğruluk veya ölçülebilir biçimde daha hızlı iddiaları geçerli mi? Yalnızca yayımlanmış metodoloji ve signoff ile desteklenirse. Aksi halde gösterge olarak değerlendirin.
Sorun giderme
| Sorun | Önerilen çözüm |
|---|---|
| Test widget'ı bulamıyor | Staging ortamınızdaki seçici ve zamanlamayı kontrol edin |
CaptchaAI ERROR_NO_SLOT_AVAILABLE döndürüyor |
Dahili pipeline'da geri çekilme ile yeniden deneyin |
| Backend QA token'ı reddediyor | Action/sitekey değerlerini gerçek yapılandırma ile karşılaştırın |
Gözlemlenebilirlik
Her QA çalıştırması için yapılandırılmış günlükler üretin. Toplam token süresi, HTTP yanıt kodu, görev kimliği ve kuyruk derinliği gibi ölçümler tablolarınızı ve uyarılarınızı besler. Ortamlarınızı (geliştirme, staging, ön üretim) ayrı kanallara yazın ve dağıtık izleme (örneğin OpenTelemetry) ile bağıntı kimliklerini eşleştirin. Tek bir kimlikten tüm senaryoyu yeniden oynatabilmek, olay sırasında tanılama süresini yarıya indirir.
Kontrol listesi
- Kapsam kesinlikle kendi uygulamalarınız veya yetkilendirilmiş kaynaklarla sınırlıdır.
- CaptchaAI anahtarı CI gizli deposunda veya kasada saklanır, kaynak kodda asla bulunmaz.
- Her çalıştırma için çağrı süresi ve yanıt kodu kayıt altına alınır.
- Geçici hatalar için idempotent yeniden deneme stratejisi kuruludur.
- Testler sürekli entegrasyon ortamınızdan tekrarlanabilir biçimde yeniden oynatılır.
Örnek QA çağrısı
Aşağıdaki Python örneği, kendi staging ortamınızdaki bir CAPTCHA widget'ını CaptchaAI üzerinden test etmek için kullanılan minimal akışı gösterir.
import os
import requests
API_KEY = os.environ['CAPTCHAAI_KEY']
QA_PAGE_URL = os.environ['QA_PAGE_URL'] # ör. https://staging.example.com/qa-login
QA_SITE_KEY = os.environ['QA_SITE_KEY']
def submit_qa_recaptcha() -> str:
payload = {
'clientKey': API_KEY,
'task': {
'type': 'NoCaptchaTaskProxyless',
'websiteURL': QA_PAGE_URL,
'websiteKey': QA_SITE_KEY,
},
}
response = requests.post(
'https://api.captchaai.com/createTask',
json=payload,
timeout=30,
)
response.raise_for_status()
return response.json()['taskId']
def fetch_qa_result(task_id: str) -> dict:
payload = {'clientKey': API_KEY, 'taskId': task_id}
response = requests.post(
'https://api.captchaai.com/getTaskResult',
json=payload,
timeout=30,
)
response.raise_for_status()
return response.json()
Sık sorulan sorular
Bu akış üretim trafiğine dokunur mu?
Hayır. Tüm örnekler staging.example.com veya kendi QA alan adınız gibi yetkilendirilmiş ortamları varsayar. Üretim CAPTCHA korumasını kendi staging kopyanızda yeniden üretin.
API anahtarımı kodda saklayabilir miyim?
Hayır. Anahtarı CI gizli yöneticisi, ortam değişkeni veya kasa hizmeti üzerinden enjekte edin. Kod tabanına işlenen anahtarlar derhal döndürülmelidir.
Geçici hatalar için ne öneriyorsunuz?
İdempotent yeniden deneme: üstel geri çekilme (örneğin 1s, 2s, 4s) ve üst sınır ile birlikte. Ağ hataları, 5xx yanıtları ve ERROR_NO_SLOT_AVAILABLE için yeniden deneme uygundur; kalıcı kimlik doğrulama hataları için değildir.
Güvenli ilgili kılavuzlar
- CaptchaAI hızlı başlangıç
- Yetkili CAPTCHA QA testleri
- Kendi formlarınızda CAPTCHA endpoint testleri
- Tarayıcı testi başarısız ama API başarılı: hata ayıklama
- reCAPTCHA v2 API ile çözme
- Cloudflare Turnstile API ile çözme
- GeeTest v3 API ile çözme
CAPTCHA entegrasyonunuzu kendi ortamınızda CaptchaAI ile doğrulayın.