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

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

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

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

Android लाइब्रेरी के उपयोगकर्ताओं के लिए, स्थिति के कामयाब होने पर, रिस्पॉन्स टोकन पाने के लिए, SafetyNetApi.RecamTokenResult.getTokenResult() तरीके का इस्तेमाल किया जा सकता है.

टोकन की पाबंदियां

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

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

एपीआई अनुरोध

यूआरएल: https://www.google.com/recca/api/siteverify METHOD: POST

POST पैरामीटर	जानकारी
सीक्रेट	ज़रूरी है. आपकी साइट और reCAPTCHA के बीच शेयर की गई कुंजी.
जवाब	ज़रूरी है. आपकी साइट पर 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
}

गड़बड़ी कोड का रेफ़रंस

गड़बड़ी का कोड	जानकारी
इनपुट-सीक्रेट मौजूद नहीं है	सीक्रेट पैरामीटर मौजूद नहीं है.
अमान्य-इनपुट सीक्रेट	सीक्रेट पैरामीटर अमान्य है या गलत है.
इनपुट इनपुट मौजूद नहीं है	रिस्पॉन्स पैरामीटर मौजूद नहीं है.
अमान्य इनपुट-रिस्पॉन्स	रिस्पॉन्स पैरामीटर अमान्य या गलत है.
गलत अनुरोध	अनुरोध अमान्य या गलत है.
टाइम आउट या डुप्लीकेट	जवाब अब मान्य नहीं है: या तो बहुत पुराना है या पहले इस्तेमाल किया जा चुका है.