İçeriğe geç
DurumPanel

API başvurusu

report — sonuç bildirimi

Bu sayfa Çince sürümden makine çevirisiyle hazırlanmıştır ve hatalar içerebilir. Geçerli olan Çince sürüm sürümüdür.

report, bir grup görevin tanıma sonucunun doğru olup olmadığını bize bildirmek için kullanılır. Başarıları da başarısızlıkları da bildirin. Görsel tanıma türlerinde “hatalı” olarak bildirilen ve koşulları sağlayan görevlerin puanları yaklaşık 24 saat sonra iade edilir; bildirilen sonuçlar tanımayı değerlendirmek ve geliştirmek için de kullanılır.

POSThttps://api.yescaptcha.com/reportGlobal uç nokta
POSThttps://cn.yescaptcha.com/reportÇin uç noktası
Alan Tür Zorunlu Açıklama
id array of string Evet Görev ID’si listesi; tek seferde birden fazla görev bildirilebilir
isSuccess boolean Evet true tanıma doğru, false tanıma hatalı

clientKey gerekmez; görev ID’si görevi zaten belirler.

{
"id": ["610ff5e0-68eb-11ef-95a6-22e70a0b794d", "65b88c06-68eb-11ef-8e9a-52540023ccb3"],
"isSuccess": false
}
{
"errorId": 0,
"status": "success"
}

Bildirimler hem bildirim sonrası puan iadesinin hesaplanmasında hem de tanımanın değerlendirilip geliştirilmesinde kullanılır; lütfen gerçek sonuca göre bildirin:

  • Doğru tanınan görevler için isSuccess: true, hatalı olanlar için false bildirin. Yalnızca başarısızlıkları bildiren veya sonuç ne olursa olsun her şeyi başarısız olarak bildiren kayıtlar, istatistiklerde ve hesaplamada dikkate alınmaz.
  • Başarısızlık oranı, yalnızca bildirdiğiniz görevler üzerinden değil, bu dönemde oluşturduğunuz tüm görevler üzerinden hesaplanır. Daha fazla başarısızlık bildirmek daha fazla puan iadesi getirmez: başarısızlık oranınız aynı dönemin oranından belirgin biçimde yüksekse, iade yalnızca aynı dönemin başarısızlık oranı üzerinden yapılır.
  • Tek bir doğrulama birden fazla görsel kullanıyorsa (örneğin FunCaptcha’da 5 tur seçim gerekir) ve hangisinin hatalı olduğunu bilmiyorsanız, bu görev grubunu birlikte başarısız olarak bildirebilirsiniz; doğrulama geçtiğinde de aynı grubu birlikte başarılı olarak bildirin.
  • Yalnızca 5 görsel tanıma türünde puan iadesi yapılır: FunCaptchaClassification, HCaptchaClassification, ReCaptchaV2Classification, AwsClassification, bCaptchaClassification.
  • Yalnızca görev oluşturulduktan sonra 1 saat içinde yapılan bildirimler geçerlidir; aynı görev için yalnızca bir kez iade yapılır.
  • İade anında yapılmaz, yaklaşık 24 saat sonra toplu olarak hesaplanır.
  • Hesaplama sırasında, aynı dönemde aynı sorular üzerinde çalışan diğer kullanıcılarla karşılaştırma yapılır; bildirilen başarısızlık oranı aynı dönemin düzeyinden belirgin biçimde yüksekse, iade aynı dönemin başarısızlık oranı üzerinden yapılır.
  • Hesaplamaya itirazınız varsa Destek ile iletişime geçerek itiraz edebilirsiniz.

Token döndüren görev türlerinde (reCAPTCHA, hCaptcha, Turnstile, FunCaptcha vb.) token’ın geçip geçmediğine hedef site karar verir; bu nedenle bildirim sonrası puan iadesi yapılmaz. Faturalandırma kurallarının özeti için Faturalandırma ve puan iadesi sayfasına bakın.