کد ERROR_NO_SUCH_METHOD
مشکلی در درخواست JSON POST که ارسال کردهاید وجود دارد.
لطفا با دقت بیشتری مستندات API ما را بخوانید.
لطفا با دقت بیشتری مستندات API ما را بخوانید.
ERROR_INCORRECT_SESSION_DATA – چیزی سرجایش نیست
برخی از مقدارهای موردنیاز برای تقلید موفق کاربر در جای مناسب وجود ندارند. یعنی وظیفهای را ارسال کردهاید که مشکلی در آن وجود دارد.
لطفاً شرح کامل خطا که API تولید کرده است را بخوانید تا بفهمید چه کاری را اشتباه انجام دادهاید. اگر نمیدانید چگونه این کار را انجام دهید با توسعه دهندگان اپ خودتان تماس بگیرید تا آنها در این زمینه به شما کمک کنند.
لطفاً شرح کامل خطا که API تولید کرده است را بخوانید تا بفهمید چه کاری را اشتباه انجام دادهاید. اگر نمیدانید چگونه این کار را انجام دهید با توسعه دهندگان اپ خودتان تماس بگیرید تا آنها در این زمینه به شما کمک کنند.
کد ERROR_NO_SUCH_CAPCHA_ID را دریافت میکنم.
کد ERROR_NO_SUCH_CAPCHA_ID وقتی دیده میشود که نمی توانیم وظیفه تعیین شده توسط ID آن را در مجموعه ای از کپچاهای در حال پردازش پیدا کنیم.
ما هر وظیفه کپچا را بعد از اینکه یکی از کارگرانمان آن وظیفه را انجام داد تا 60 ثانیه اضافه نگهداری می کنیم.
پس از این دوره، این وظیفه از مجموعه کپچای فعال حذف میشود و از طریق API غیرقابلدسترس میشود.
برای اینکه از این خطا جلوگیری کنید توصیه میکنیم کارهای زیر را انجام دهید:
۱. بعد از ایجاد وظیفه با متد createTask ، هر ۵ ثانیه یا در همین حدود، نتیجه وظیفه را با متد getTaskResult درخواست کنید.
۲. کپچاهای نادرست/درست را ظرف ۶۰ ثانیه پس از تکمیل کار یا زودتر گزارش کنید.
شاید مدتزمان ۶۰ ثانیه کافی به نظر نرسد اما در اکثر موارد طول عمر توکنهای ریکپچا و نتایج کپچای تصویری به همین اندازه است.
یک مشکل خاص مربوط به برنامهنویسی بد اغلب در شرایطی ایجاد میشود که نرمافزارتان کارهای زیر را انجام دهد:
۱. درخواست ایجاد وظیفه را به متد createTask میفرستد و به همین دلیل taskId مناسب را دریافت نمیکند.
۲. به دلیل تجزیه بد نتیجه متد createTask فرض میکند که taskId مناسب را دریافت کرده است.
۳. درخواستهایی را با این ID نادرست به متد getTaskResult میفرستد که خطای ERROR_NO_SUCH_CAPCHA_ID را برمیگرداند.
گاهی اوقات مشاهده میکنیم که برخی کاربران NULL ، ۰ کاذب، ""، یا موارد مشابه را بهصورت taskId ارسال میکنند. این درخواستها همیشه ERROR_NO_SUCH_CAPCHA_ID را تولید میکنند.
اگر حساب کاربر به صدهزار خطای ERROR_NO_SUCH_CAPCHA_ID در ۲۴ ساعت برسد، کلید حسابش مسدود میشود و مجبور است تا تیکت پشتیبانی را برای ما همراه با توضیح وضعیت ارسال کند. ما از او میخواهیم اثبات کند که کد مشکلدار را درست کرده است. چند روز طول میکشد تا این درخواستهای پشتیبانی پردازش شوند.
ما هر وظیفه کپچا را بعد از اینکه یکی از کارگرانمان آن وظیفه را انجام داد تا 60 ثانیه اضافه نگهداری می کنیم.
پس از این دوره، این وظیفه از مجموعه کپچای فعال حذف میشود و از طریق API غیرقابلدسترس میشود.
برای اینکه از این خطا جلوگیری کنید توصیه میکنیم کارهای زیر را انجام دهید:
۱. بعد از ایجاد وظیفه با متد createTask ، هر ۵ ثانیه یا در همین حدود، نتیجه وظیفه را با متد getTaskResult درخواست کنید.
۲. کپچاهای نادرست/درست را ظرف ۶۰ ثانیه پس از تکمیل کار یا زودتر گزارش کنید.
شاید مدتزمان ۶۰ ثانیه کافی به نظر نرسد اما در اکثر موارد طول عمر توکنهای ریکپچا و نتایج کپچای تصویری به همین اندازه است.
یک مشکل خاص مربوط به برنامهنویسی بد اغلب در شرایطی ایجاد میشود که نرمافزارتان کارهای زیر را انجام دهد:
۱. درخواست ایجاد وظیفه را به متد createTask میفرستد و به همین دلیل taskId مناسب را دریافت نمیکند.
۲. به دلیل تجزیه بد نتیجه متد createTask فرض میکند که taskId مناسب را دریافت کرده است.
۳. درخواستهایی را با این ID نادرست به متد getTaskResult میفرستد که خطای ERROR_NO_SUCH_CAPCHA_ID را برمیگرداند.
گاهی اوقات مشاهده میکنیم که برخی کاربران NULL ، ۰ کاذب، ""، یا موارد مشابه را بهصورت taskId ارسال میکنند. این درخواستها همیشه ERROR_NO_SUCH_CAPCHA_ID را تولید میکنند.
اگر حساب کاربر به صدهزار خطای ERROR_NO_SUCH_CAPCHA_ID در ۲۴ ساعت برسد، کلید حسابش مسدود میشود و مجبور است تا تیکت پشتیبانی را برای ما همراه با توضیح وضعیت ارسال کند. ما از او میخواهیم اثبات کند که کد مشکلدار را درست کرده است. چند روز طول میکشد تا این درخواستهای پشتیبانی پردازش شوند.
کد ERROR_NO_SLOT_AVAILABLE را دریافت میکنم.
ERROR_NO_SLOT_AVAILABLE هنگامی ارسال میشود که کارگری وجود نداشته باشد و ازدحام بیش از حدی در صف حل کپچا وجود داشته باشد.
اگرچه همچنان با پرداخت مبلغی بیش از سایر مشتریان میتوانید بهسادگی به صف وارد شوید. تنظیمات «حداکثر پیشنهاد» برای همین کار است.
با تنظیم فرایند حل در تنظیمات API میتوانید «حداکثر پیشنهاد» را مدیریت کنید.
اگرچه همچنان با پرداخت مبلغی بیش از سایر مشتریان میتوانید بهسادگی به صف وارد شوید. تنظیمات «حداکثر پیشنهاد» برای همین کار است.
با تنظیم فرایند حل در تنظیمات API میتوانید «حداکثر پیشنهاد» را مدیریت کنید.
کد ERROR_KEY_DOES_NOT_EXIST را دریافت میکنم
این خطا یعنی نرمافزارتان در حال ارسال کوئریهایی با کلید دسترسی نادرست است.
ما بعد از ۱۰۰ تلاش نادرست در یک ساعت، IP ها را مسدود میکنیم تا از حملات بروت - فورس جلوگیری کنیم.
۱. کلید درون اپلیکیشن را چک کنید تا آپدیت شده باشد، به تنظیمات API بروید و کلید را کپی کنید.
۲. مطمئن شوید که فیلد کلید حاوی اسپیس یا کاراکتر ویژه دیگری نیست.
۳. اگر مطمئن هستید که هر بار از کلید صحیح استفاده میکنید، از ارائهدهنده نرمافزارتان کمک بخواهید. ما در این شرایط نمیتوانیم کمکی به شما کنیم - مشکل به نرمافزار خودتان مربوط میشود.
۴. اگر توسعهدهنده نرمافزار خودتان هستید، مراحل زیر را دنبال کنید:
بهاحتمال زیاد در حال ارسال نادرست JSON به API ما هستید.
سریعترین راه برای جلوگیری از این خطا این است که از نمونههای API رسمی ما که در مستندات درج شدهاند، استفاده کنید.
اگر خودتان قصد دارید چیزی را بسازید، درخواستهایتان را در این آدرس تست کنید: https://api.anti-captcha.com/test
این آدرس به شما نشان میدهد که واقعاً در حال ارسال چه چیزی هستید. به خاطر داشته باشید که باید درخواستهایتان را در JSON POST ارسال کنید. همه درخواستهای داده باید زیر بخش "Parsed input JSON" چاپ شوند و باید بهصورت یک آرایه باشند. مطمئن شوید که ساختار JSON درخواستشده دقیقاً با ساختار مستندات تطابق دارد. توجه کنید که همه نامهای خصوصیت، به کوچکی و بزرگی حروف حساس هستند.
اگر به اندازه کافی دقت کنید، مشکل را پیدا خواهید کرد.
اگر همچنان مشکل دارید، یک نمونهی JSON از درخواستتان را در یک تیکت برایمان بفرستید.
ما بعد از ۱۰۰ تلاش نادرست در یک ساعت، IP ها را مسدود میکنیم تا از حملات بروت - فورس جلوگیری کنیم.
۱. کلید درون اپلیکیشن را چک کنید تا آپدیت شده باشد، به تنظیمات API بروید و کلید را کپی کنید.
۲. مطمئن شوید که فیلد کلید حاوی اسپیس یا کاراکتر ویژه دیگری نیست.
۳. اگر مطمئن هستید که هر بار از کلید صحیح استفاده میکنید، از ارائهدهنده نرمافزارتان کمک بخواهید. ما در این شرایط نمیتوانیم کمکی به شما کنیم - مشکل به نرمافزار خودتان مربوط میشود.
۴. اگر توسعهدهنده نرمافزار خودتان هستید، مراحل زیر را دنبال کنید:
بهاحتمال زیاد در حال ارسال نادرست JSON به API ما هستید.
سریعترین راه برای جلوگیری از این خطا این است که از نمونههای API رسمی ما که در مستندات درج شدهاند، استفاده کنید.
اگر خودتان قصد دارید چیزی را بسازید، درخواستهایتان را در این آدرس تست کنید: https://api.anti-captcha.com/test
این آدرس به شما نشان میدهد که واقعاً در حال ارسال چه چیزی هستید. به خاطر داشته باشید که باید درخواستهایتان را در JSON POST ارسال کنید. همه درخواستهای داده باید زیر بخش "Parsed input JSON" چاپ شوند و باید بهصورت یک آرایه باشند. مطمئن شوید که ساختار JSON درخواستشده دقیقاً با ساختار مستندات تطابق دارد. توجه کنید که همه نامهای خصوصیت، به کوچکی و بزرگی حروف حساس هستند.
اگر به اندازه کافی دقت کنید، مشکل را پیدا خواهید کرد.
اگر همچنان مشکل دارید، یک نمونهی JSON از درخواستتان را در یک تیکت برایمان بفرستید.
ERROR_CAPTCHA_UNSOLVABLE – برای وظایفی مثل این برایم صورتحساب صادر شده است؟
بله برایتان صورتحساب صادر میشود و سایر افراد نیز باید صورتحسابشان را بپردازند زیرا کارگرانمان رایگان کار نمیکنند. اگر این کار را رایگان انجام دهیم، روز بعد تعداد زیادی هکر خانگی، API ما را با حجم زیادی از کپچاهای تصویری بسیار سخت و وظایف پروکسی کُند روبرو میکنند و کارمان تمام خواهد بود.
شما هم از سمت خودتان باید روی سرعت پروکسی کار کنید. ما درباره ریکپچا صحبت میکنیم و اگر یک کپچای تصویری معمولی وجود داشته باشد، کپچاهای تصویری بسیار سخت را فیلتر میکنیم.
در ریکپچاها ما محدودیت ۳ تلاش برای هر وظیفه را داریم.
در کپچاهای تصویری ما محدودیت ۵ تلاش برای هر وظیفه را داریم.
یعنی قبل از اینکه وظیفه شما از صف خارج شود، ۳ یا ۵ کارگر متفاوت سعی خواهند کرد تا کار شما را انجام دهند.
شما هم از سمت خودتان باید روی سرعت پروکسی کار کنید. ما درباره ریکپچا صحبت میکنیم و اگر یک کپچای تصویری معمولی وجود داشته باشد، کپچاهای تصویری بسیار سخت را فیلتر میکنیم.
در ریکپچاها ما محدودیت ۳ تلاش برای هر وظیفه را داریم.
در کپچاهای تصویری ما محدودیت ۵ تلاش برای هر وظیفه را داریم.
یعنی قبل از اینکه وظیفه شما از صف خارج شود، ۳ یا ۵ کارگر متفاوت سعی خواهند کرد تا کار شما را انجام دهند.
ERROR_PROXY_BANNED، گوگل پروکسی را مسدود کرده است
گوگل پروکسیتان را مسدود کرده است و تا ابتدای ساعت بعد، وظیفهتان پذیرفته نخواهد شد.
حتی اگر در حل ریکپچا با پروکسی مسدود شده موفق شوید، به معنای آن نیست که ما هم به موفقیت مشابهی برسیم. باید پروکسی را عوض کنید یا از حالت بدون پروکسی در بخش «API override» در تنظیمات API استفاده کنید.
توجه داشته باشید که گوگل جفتهای «IP-UserAgent» را مسدود میکند پس تغییر پارامتر userAgent در درخواست API ممکن است در برخی وضعیتها مفید باشد.
این خطایی است که در سمت کارگر دیده میشود:

حتی اگر در حل ریکپچا با پروکسی مسدود شده موفق شوید، به معنای آن نیست که ما هم به موفقیت مشابهی برسیم. باید پروکسی را عوض کنید یا از حالت بدون پروکسی در بخش «API override» در تنظیمات API استفاده کنید.
توجه داشته باشید که گوگل جفتهای «IP-UserAgent» را مسدود میکند پس تغییر پارامتر userAgent در درخواست API ممکن است در برخی وضعیتها مفید باشد.
این خطایی است که در سمت کارگر دیده میشود:

کد ERROR_IMAGE_TYPE_NOT_SUPPORTED
۱. مطمئن شوید که بدنه رمزگذاریشده تصویر JPG، GIF یا PNG را بهدرستی ارسال میکنید.
۲. مطمئن شوید که "data:image/jpeg;base64," یا موارد مشابه را از رمزگذاری پایه ۶۴ (بیس ۶۴) حذف کردهاید.
۳. از مثالهای کد رسمی برای ارسال کپچاهایتان استفاده کنید. این مثالها کار را بهدرستی انجام میدهند.
۲. مطمئن شوید که "data:image/jpeg;base64," یا موارد مشابه را از رمزگذاری پایه ۶۴ (بیس ۶۴) حذف کردهاید.
۳. از مثالهای کد رسمی برای ارسال کپچاهایتان استفاده کنید. این مثالها کار را بهدرستی انجام میدهند.
ERROR_RECAPTCHA_INVALID_SITEKEY - وقتی کلید صحیح است هم این خطا را میگیرم
حتماً یکی از موارد زیر صحیح نیستند:
a) کلید سایت
b) دامنه (دامین)
چگونه دامنه صحیح را بازیابی کنیم:
۱. این خودآموز را دنبال کنید و پلاگین Firebug را نصب کنید.
۲. به وبسایت هدف بروید، درخواست مشابهی به سرور گوگل را با کلید سایت پیدا کنید. آدرسی که به آن اشاره دارد را پیدا کنید. این دامنهای است که باید به API ما بفرستید.

a) کلید سایت
b) دامنه (دامین)
چگونه دامنه صحیح را بازیابی کنیم:
۱. این خودآموز را دنبال کنید و پلاگین Firebug را نصب کنید.
۲. به وبسایت هدف بروید، درخواست مشابهی به سرور گوگل را با کلید سایت پیدا کنید. آدرسی که به آن اشاره دارد را پیدا کنید. این دامنهای است که باید به API ما بفرستید.

ERROR_TOKEN_EXPIRED و geetest کپچا
خطای «انقضای توکن» وقتی ظاهر میشود که کارگر در تکمیل حل کپچا شکست میخورد یا حل کپچا را لغو میکند، بنابراین توکن «چالش» که در وظیفه کپچایتان ارائه کردهاید، منقضی میشود. در این صورت، نرمافزارتان باید توکن چالش جدیدی بگیرد و دوباره تلاش کند.
نکته مهم: این توکنهای چالش فقط یکبار مصرف هستند، یعنی ویجت کپچا را فقط یکبار با یک توکن منفرد میتوان رندر کرد.
اگر دائماً این خطا را برای همه وظایفتان دریافت میکنید، باید مطمئن شوید که همه پارامترهای در دسترس مثل زیردامنه (سابدامین) را به API ما ارسال میکنید. مستندات مربوط به آنها را باید بهدقت اینجا بخوانید. دو مثال کاری که این دو گزینه را حل میکنند را میتوانoptions can be found در اینجا در Github پیدا کرد.
نکته مهم: این توکنهای چالش فقط یکبار مصرف هستند، یعنی ویجت کپچا را فقط یکبار با یک توکن منفرد میتوان رندر کرد.
اگر دائماً این خطا را برای همه وظایفتان دریافت میکنید، باید مطمئن شوید که همه پارامترهای در دسترس مثل زیردامنه (سابدامین) را به API ما ارسال میکنید. مستندات مربوط به آنها را باید بهدقت اینجا بخوانید. دو مثال کاری که این دو گزینه را حل میکنند را میتوانoptions can be found در اینجا در Github پیدا کرد.
ERROR_TASK_ABSENT – چه اتفاقی افتاد؟
احتمالاً در حال ارسال JSON به API ما به شیوه نادرستی هستید.
استفاده از نمونههای API رسمی ما از مستنداتمان، سادهترین راه برای جلوگیری از این خطا است.
اگر خودتان چیزی میسازید، درخواستهایتان را در این آدرس تست کنید: https://api.anti-captcha.com/test
این صفحه به شما نشان میدهد که واقعاً چه چیزی را ارسال میکنید.
بهخاطر داشته باشید که باید درخواستهایتان را در JSON POST بفرستید. ما به این دلیل از آن استفاده میکنیم که اشیای پیچیده را در درخواستهای HTTP ارسال میکند.
استفاده از نمونههای API رسمی ما از مستنداتمان، سادهترین راه برای جلوگیری از این خطا است.
اگر خودتان چیزی میسازید، درخواستهایتان را در این آدرس تست کنید: https://api.anti-captcha.com/test
این صفحه به شما نشان میدهد که واقعاً چه چیزی را ارسال میکنید.
بهخاطر داشته باشید که باید درخواستهایتان را در JSON POST بفرستید. ما به این دلیل از آن استفاده میکنیم که اشیای پیچیده را در درخواستهای HTTP ارسال میکند.
ERROR_WRONG_FLAGS
Error code ERROR_WRONG_FLAGS is assigned to a text captcha when worker decides that captcha requirements like "numeric", "minimum length" are not accomplishable and presses button in their interface "incorrect flags". You are paying for such images because you're spending worker's time. This button, however, is not available to workers when no flags are sent along with a captcha image. Decision wether to use flags are not is up to the customer.
Full list of available flags is available at ImageToTextTask task description page.
Full list of available flags is available at ImageToTextTask task description page.
ERROR_BAD_DUPLICATES چیست؟
ERROR_BAD_DUPLICATES هنگامی اتفاق میافتد که یک «ویژگی ۱۰۰%» ، کپیهای کپچای کافی نداشته باشد که با یک پاسخ قابلقبول تطابق داشته باشند.
چون همه کپیها بهصورت انفرادی توسط کارگران متفاوتی حل میشوند، حسابتان برای هر وظیفه تکراری شارژ میشود، چه صحیح باشد و چه صحیح نباشد.
چون همه کپیها بهصورت انفرادی توسط کارگران متفاوتی حل میشوند، حسابتان برای هر وظیفه تکراری شارژ میشود، چه صحیح باشد و چه صحیح نباشد.