در حال تایید پاسخ کاربر

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

برای کاربران وب، می توانید نشانه پاسخ کاربر را به یکی از سه روش دریافت کنید:

  • پارامتر POST g-recaptcha-response زمانی که کاربر فرم را در سایت شما ارسال می کند
  • grecaptcha.getResponse(opt_widget_id) پس از تکمیل چالش reCAPTCHA توسط کاربر
  • به عنوان یک آرگومان رشته ای برای تابع callback شما اگر data-callback در ویژگی تگ g-recaptcha یا پارامتر callback در متد grecaptcha.render مشخص شده باشد.

برای کاربران کتابخانه اندروید، می‌توانید متد SafetyNetApi.RecaptchaTokenResult.getTokenResult() را فراخوانی کنید تا در صورت موفقیت آمیز بودن وضعیت، کد پاسخ را دریافت کنید.

محدودیت های توکن

هر کد پاسخ کاربر reCAPTCHA به مدت دو دقیقه معتبر است و فقط یک بار برای جلوگیری از حملات مجدد قابل تأیید است. اگر به یک توکن جدید نیاز دارید، می‌توانید تأیید reCAPTCHA را دوباره اجرا کنید.

پس از دریافت رمز پاسخ، باید آن را در عرض دو دقیقه با reCAPTCHA با استفاده از API زیر تأیید کنید تا مطمئن شوید که رمز معتبر است.

درخواست API

URL: https://www.google.com/recaptcha/api/siteverify

روش: POST

پارامتر POST توضیحات
secret مورد نیاز. کلید مشترک بین سایت شما و reCAPTCHA.
response مورد نیاز. نشانه پاسخ کاربر ارائه شده توسط ادغام سمت مشتری reCAPTCHA در سایت شما.
remoteip اختیاری. آدرس IP کاربر.

پاسخ API

پاسخ یک شی JSON است:

{
  "success": true|false,
  "challenge_ts": timestamp,  // timestamp of the challenge load (ISO format yyyy-MM-dd'T'HH:mm:ssZZ)
  "hostname": string,         // the hostname of the site where the reCAPTCHA was solved
  "error-codes": [...]        // optional
}

برای reCAPTCHA Android:

{
  "success": true|false,
  "challenge_ts": timestamp,  // timestamp of the challenge load (ISO format yyyy-MM-dd'T'HH:mm:ssZZ)
  "apk_package_name": string, // the package name of the app where the reCAPTCHA was solved
  "error-codes": [...]        // optional
}

مرجع کد خطا

کد خطا توضیحات
missing-input-secret پارامتر مخفی وجود ندارد.
invalid-input-secret پارامتر مخفی نامعتبر یا بد شکل است.
missing-input-response پارامتر پاسخ وجود ندارد.
invalid-input-response پارامتر پاسخ نامعتبر یا نادرست است.
bad-request درخواست نامعتبر یا نادرست است.
timeout-or-duplicate پاسخ دیگر معتبر نیست: یا خیلی قدیمی است یا قبلاً استفاده شده است.