उपयोगकर्ता के जवाब की पुष्टि करना

यह पेज आपके ऐप्लिकेशन की reCAPTCHA चुनौती के प्रति उपयोगकर्ता के जवाब की पुष्टि करने का तरीका बताता है बैकएंड.

वेब उपयोगकर्ताओं के लिए, आपको इन तीन में से किसी एक तरीके से उपयोगकर्ता का रिस्पॉन्स टोकन मिल सकता है:

• जब उपयोगकर्ता आपकी साइट पर फ़ॉर्म सबमिट करता है, तब g-recaptcha-response पीओएसटी पैरामीटर
• उपयोगकर्ता के पूरा करने के बाद grecaptcha.getResponse(opt_widget_id) reCAPTCHA चुनौती
• आपके callback फ़ंक्शन में स्ट्रिंग तर्क के रूप में अगर data-callback को g-recaptcha टैग एट्रिब्यूट में बताया गया है या grecaptcha.render तरीके में कॉलबैक पैरामीटर

Android लाइब्रेरी का इस्तेमाल करने वाले लोग, SafetyNetApi.RecaptchaTokenResult.getTokenResult() का इस्तेमाल करें.

टोकन से जुड़ी पाबंदियां

reCAPTCHA उपयोगकर्ता के हर रिस्पॉन्स टोकन की समयसीमा दो मिनट के लिए मान्य होती है. इसकी पुष्टि, सिर्फ़ एक बार फिर से चलाने के हमलों से बचें. अगर आपको नए टोकन की ज़रूरत है, तो reCAPTCHA की पुष्टि फिर से करें.

रिस्पॉन्स टोकन मिलने के बाद, आपको दो मिनट के अंदर reCAPTCHA की मदद से इसकी पुष्टि करनी होगी एपीआई का पालन करें, ताकि यह पक्का किया जा सके कि टोकन मान्य है.

एपीआई अनुरोध

यूआरएल: https://www.google.com/re कैप्चा/api/siteverify तरीका: पीओएसटी

पीओएसटी पैरामीटर	ब्यौरा
secret	ज़रूरी है. आपकी साइट और reCAPTCHA के बीच शेयर की गई कुंजी.
response	ज़रूरी है. आपकी साइट पर reCAPTCHA क्लाइंट-साइड इंटिग्रेशन से मिला उपयोगकर्ता रिस्पॉन्स टोकन.
remoteip	ज़रूरी नहीं. उपयोगकर्ता का आईपी पता.

एपीआई से मिला रिस्पॉन्स

रिस्पॉन्स, एक 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	रिस्पॉन्स पैरामीटर अमान्य या गलत है.
खराब अनुरोध	अनुरोध अमान्य या गलत है.
टाइम आउट-या-डुप्लीकेट	जवाब अब मान्य नहीं है: या तो बहुत पुराना है या पहले ही इस्तेमाल किया जा चुका है.