منوی مستندات

reportCorrectRecaptcha: گزارش توکن‌های ریکپچای حل شده صحیح

از این متد همراه با reportIncorrectRecaptcha برای وظایف Recaptcha V3 و Recaptcha V2 Enterprise خودتان استفاده کنید. در حال حاضر گزارش‌های Recaptcha V2 پذیرفته می‌شوند اما نهایتاً نادیده گرفته می‌شوند. کیفیت ما برای V2 برابر با 99% است و نیازی ندارید تا وایت‌لیستی از کارگران موفق بسازید.

ما کارگری که گزارش کرده‌اید را در پشت‌صحنه در وایت‌لیست قرار خواهیم داد، و سیستم ما در دور بعدی تخصیص کارگران به کپچاهایتان این وایت لیست را با کپچاهای شما تطبیق می‌دهد. اگر هرکدام از کارگران گزارش شده، آنلاین یا بیکار باشند او در اولویت اول تخصیص وظیفه به کار شما قرار می‌گیرد. سیستم، این پرونده را برای ساعت بعد نگهداری می‌کند و اگر درخواست reportIncorrectRecaptcha را برای یک وظیفه بفرستید که توسط کارگر مشابهی از وایت لیست اجرا می‌شود، آنگاه شاید این پرونده را حذف کند.
به طور خلاصه می‌توان گفت که گزارش ریکپچای صحیح باعث می‌شود تا کارگران به وایت لیست شما اضافه شوند، گزارش ریکپچای false آنها را حذف می‌کند.

در حجم‌های زیاد که از 10 وظیفه در هر دقیقه شروع می‌شوند، گزارش توکن‌های حل شده صحیح، مؤثر خواهد بود. این اتفاق به دلیل جابه‌جایی زیاد کارگرانمان بین صف‌های وظایف متفاوت و وضعیت مشغول/بیکار کنونی آنها می‌افتد. اگر حجم‌های شما مثلاً 1 وظیفه در هر دقیقه باشد اصلاً متوجه هیچ‌گونه بهبود کیفیتی نخواهید شد.

گزارش‌ها باید بعد از اتمام کار ظرف 60 ثانیه فرستاده شوند. اگر بعداً گزارش را ارسال کنید، API خطای ERROR_NO_SUCH_CAPCHA_ID را برخواهد گرداند. ارسال فقط یک گزارش برای هر وظیفه مجاز است.

آدرس: https://api.anti-captcha.com/reportCorrectRecaptcha
متد: POST
Content-type: application-json

خصوصیات درخواست

خصوصیت نوع موردنیاز هدف
clientKey رشته بله
taskId عدد صحیح بله

نمونه درخواست

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "taskId":12345
}' https://api.anti-captcha.com/reportCorrectRecaptcha
        


ساختار پاسخ

خصوصیت نوع هدف
errorId عدد صحیح شناسه خطا.
0 - بدون خطا - عملیات با موفقیت به اتمام رسید.
1 - شناسه خطا. کد خطا و شرح کوتاه در خصوصیات errorCode و errorDescription منتقل می‌شوند.
errorCode رشته
errorDescription رشته شرح کوتاهی از خطا
status رشته
نتیجه عملیات. وقتی شکایت پذیرفته می‌شود، شما یا یک کد خطا یا وضعیت = "موفق" را دریافت می‌کنید.

نمونه پاسخ

JSON بدون هیچ خطایی
          {
    "errorId":0,
    "status":"success"
}
        
JSON با یک خطا
          {
    "errorId": 16,
    "errorCode": "ERROR_NO_SUCH_CAPCHA_ID",
    "errorDescription": "Task you are requesting does not exist in your current task list or has been expired."
}