API से मानक reCAPTCHA v3 हल करें

मानक v3 के लिए भी आपके वर्कस्पेस में उपलब्ध सक्रिय साइट प्रोफ़ाइल ज़रूरी है। टास्क बनाने से पहले कंसोल में लक्ष्य साइट सेट अप करें; होस्टनाम और ऐक्शन भेजने से प्रोफ़ाइल नहीं बनती।

• site: लक्ष्य होस्टनाम, जैसे accounts.example.com, पूरा पेज URL नहीं।
• action: लक्ष्य के reCAPTCHA इंटीग्रेशन में इस्तेमाल होने वाला ऐक्शन। अगर लक्ष्य कोई और ऐक्शन इस्तेमाल करता है, तो उदाहरण के login को बदलें। ऐक्शन कैसे ढूँढें देखें।
• proxy या proxyCandidates: इनमें से ठीक एक दें। उदाहरण एक प्रॉक्सी का उपयोग करता है। अगर इसके बजाय कैंडिडेट इस्तेमाल करते हैं, तो सूची में अधिकतम बारह अलग-अलग HTTP या HTTPS प्रॉक्सी URL हो सकते हैं, जिनमें पाथ, क्वेरी या फ़्रैगमेंट न हो।

यह JSON बॉडी POST https://api.solvethree.com/v1/tasks पर भेजें। Bearer स्कीम का उपयोग करके Authorization हेडर में वर्कस्पेस API कुंजी से प्रमाणीकरण करें। कुंजी अपने सर्वर पर रखें।

{
  "site": "accounts.example.com",
  "action": "login",
  "recaptchaType": "v3",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "v3-login-001"
}

recaptchaType को site, action और proxy के साथ शीर्ष स्तर पर रखें। reCAPTCHA के लिए type या url फ़ील्ड न जोड़ें।

उदाहरण के होस्टनाम, ऐक्शन और प्रॉक्सी को अपने लक्ष्य के मानों से बदलें। हर नए तार्किक समाधान के लिए नया requestId इस्तेमाल करें। अगर टास्क बनाते समय टाइमआउट हो जाए, तो दूसरा टास्क बनाने के बजाय मौजूदा टास्क रिकवर करने के लिए वही टास्क बॉडी उसी ID के साथ दोबारा भेजें। उस ID को अलग इनपुट के साथ दोबारा इस्तेमाल करने से टकराव होता है।

1. 1.

   पहले HTTP प्रतिक्रिया जाँचें

   बॉडी को टास्क परिणाम के रूप में पढ़ने से पहले असफल HTTP प्रतिक्रिया को संभालें। स्टेटस जाँचें और बताई गई अनुरोध त्रुटि ठीक करें।

2. 2.

   टास्क पूरा होने तक उसे प्राप्त करते रहें

   टास्क बनाते समय डिफ़ॉल्ट रूप से अधिकतम 15 सेकंड प्रतीक्षा होती है; नेटवर्क ओवरहेड के लिए अपने क्लाइंट टाइमआउट में अतिरिक्त समय रखें। अगर स्टेटस pending या solving है, तो GET /v1/tasks/:id से टास्क प्राप्त करें। GET पोलिंग डिफ़ॉल्ट रूप से प्रतीक्षा नहीं करती; लॉन्ग पोलिंग के लिए waitMs में अधिकतम 15000 को URL क्वेरी पैरामीटर के रूप में दें, JSON फ़ील्ड के रूप में नहीं। ready या failed पर पोलिंग रोक दें। failed होने पर, दोबारा कोशिश करना उचित है या नहीं, यह तय करने से पहले errorCode और error जाँचें।

3. 3.

   तैयार समाधान का उपयोग करें

   इच्छित लक्ष्य पर solution.token सबमिट करें—टास्क ID नहीं। लौटाए गए userAgent और secChUa का उपयोग सफल प्रॉक्सी के साथ करें। समाधान पाने और सबमिट करने के बीच IP न बदलें और किसी असंबंधित ब्राउज़र पहचान का उपयोग न करें।

तैयार टोकन किसी खास reCAPTCHA स्कोर या लक्ष्य द्वारा स्वीकृति का प्रमाण नहीं है। reCAPTCHA v3 एक जोखिम स्कोर और ऐक्शन देता है, जिनका लक्ष्य अपने बैकएंड पर मूल्यांकन करता है; टोकन सबमिट करने वाले अनुरोध पर लक्ष्य की प्रतिक्रिया जाँचें।