نکات و راهنمایی

در این صفحه نکاتی جمع آوری شده است که ممکن است شما با آنها مواجه و دچار مشکل شوید..

در صورت مواجهه با مشکلات بیشتر و نیز دادن پیشنهاد آنها را از طریق ایمیل info[a]kingcaptcha.ir با ما مطرح کنید.

کدهای HTTP مورد نیاز

کدمعنااقدام پیشنهادی
200موفقتوکن را ذخیره و فرم را submit کنید
400خطای اعتبارسنجیپیام error را نمایش دهید، کپچا را ریست کنید
401کلید نامعتبرpublicKey/privateKey را بررسی کنید
429Rate limitپیام انتظار 2 تا یک دقیقه ای و یک خطای انتظار تا 24 ساعت

privateKey را سرورساید نگه دارید

کلید خصوصی هرگز نباید در frontend یا source control باشد. از User Secrets یا متغیر محیطی استفاده کنید.

توکن یک‌بارمصرف است

پس از یک بار فراخوانی verify-token موفق، توکن سوخته می‌شود. برای هر submission باید کپچا دوباره حل شود.

توکن ۲ دقیقه اعتبار دارد

از زمان حل چالش تا verify-token باید کمتر از TokenExpiryMinutes (پیش‌فرض ۲ دقیقه) بگذرد.

Domain باید مطابقت داشته باشد

دامنه‌ای که در پنل ثبت کرده‌اید باید با دامنه درخواست‌دهنده یکسان باشد. localhost در صورت فعال بودن پشتیبانی می‌شود.

انواع سختی

سختی در پنل توسط صاحب کپچا انتخاب می‌شود و از دیتابیس خوانده می‌شود.

  • easy
    توصیه نمیشود: برای ساده ترین حالات
    در این حالت، در بکگراند هر سه نوع خطوط و نویز دیده نمیشود و یا بسیار کم است. تعداد حروف و اعداد در نوع تصویر مخدوش کمتر و بهم ریختگی دیده نخواهد شد و در حالت اسلایدر تصویر واضحتر و بدون مربع انحرافی است.
  • medium
    پیشنهاد شده
    در این حالت، در بکگراند هر سه نوع خطوط و نویز دیده تا حدی وجود خواهد دشات. تعداد حروف و اعداد در نوع تصویر بیشتر از حالت آسان و چرخش دیده نخواهد شد و در حالت اسلایدر تصویر کمی تیره تر و با مربع انحرافی همراه خواهد بود.
  • hard
    بسیار سخت: برای فرآیندهای حساس
    در این حالت، در بکگراند هر چهار نوع خطوط و نویز بسیار دیده می شود. تعداد حروف و اعداد در نوع تصویر مخدوش زیاد و بهم ریختگی و چرخش وجود خواهد داشت و در حالت اسلایدر تصویر بسیار کدر و با مربع های انحرافی بسیاری همراه است.
    همچنین در حالت «تشریحی» کلماتِ «سوال» بهم ریخته و جابجا نشان داده شده و اندازه فونت کوچکتر از دو وضعیت دیگر خواهد بود.

انواع چالش ها

سختی در پنل توسط صاحب کپچا انتخاب می‌شود و از دیتابیس خوانده می‌شود.

  • Slider
    اسلایدر

    کاربر قطعه پازل را به داخل شکاف می‌کشد. مسیر drag تحلیل می‌شود تا بات‌ها تشخیص داده شوند.

  • ImageSelection
    انتخاب تصویر متمایز

    کاربر تصویری که با بقیه فرق دارد را انتخاب می‌کند. فیلترهای تصویر بر اساس سختی اعمال می‌شوند.

  • DistortedNumbers
    اعداد و حروف مخدوش

    کاربر اعدادی که روی تصویر مخدوش شده‌اند را وارد می‌کند. تعداد ارقام بر اساس سختی تغییر می‌کند.

  • QuestionAnswer
    سوالات تشریحی

    کاربر باید به سوالات تشریحی پاسخ تایپی بدهد. مانند «پایتخت ایران کجاست؟» جواب: تهران.

انواع وضعیت ظاهری

وضعیت ظاهری به معنای نمایش و یا عدم نمایش کپچا در صفحه شما خواهد بود.

  • وضعیت: ظاهر

    در این وضعیت مستطیل کپچا جهت کلیک (تاچ) قابل رویت خواهد بود و مقداری از فضا شما اشغال خواهد شد.

  • وضعیت: مخفی

    در این حالت، هیچ آبجکتی مشاهده نشده و پس از ارسال درخواست، چالش نمایان خواهد شد.

خطا قرمز رنگ

اگر پس از اشتباهی در قرار دادن publicKey ، کپچا با خطای زیر مواجه شد و پس از اصلاحِ publickey خطا رفع نگردید، لطفا کش مرورگر را خالی کنید. (در ویندوز Ctrl+F5)

حساسیت به حروف بزرگ و کوچک

در حالت تشخیص عدد و حروف، تنها در وضعیت سختی "هارد" حساسیت به حروف کوچک و بزرگ وجود خواهد داشت.
این حساسیت به مدل های: DistortedNumbers و QuestionAnswer تعلق خواهد گرفت.

پیچیده ترین مدل

اگر به هر دلیل به دنبال مدلی هستید که چالش برانگیزتر و براحتی پاسخ مثبت به کاربر ندهد، مدل اسلایدر پیشنهاد ماست. در این مدل؛ به دلیل محاسبه‌ی پشت پرده الگورتیم های آن، بررسی بسیار پیچیده و پاسخ مثبت به سختی حاصل می گردد.

نکته اساسی مدل «تشریحی»

این مدل صرفا برای زبان فارسی data-lang="fa" طراحی شده است.

نمایش نشان کپچاکینگ

در حالت invisible نشان کپچاکینگ در سمت راست پایین صفحه بصورت شناور و اجباری نمایش داده خواهد شد. این عمل برای کاربران حالت معرفی و نیز بازدارندگی خواهد داشت.

محدودیت در اجرای پازل ها

براساس قوانین حال حاضر؛ محدودیت هر کاربر، در «هر ساعت»، 100 درخواست (request) به سمت سرور خواهد بود. درخواست های بیش از این مقدار، کاربر را به مدت 24 ساعت مسدود خواهد کرد.