solvethree websiteKey फ़ील्ड के बजाय साइट प्रोफ़ाइल क्यों इस्तेमाल करता है
solvethree reCAPTCHA साइट कुंजी और पेज सेटअप को साइट प्रोफ़ाइल में रखता है। टास्क अनुरोध में site में होस्टनेम, action में निष्पादन ऐक्शन और एक प्रॉक्सी दी जाती है—websiteKey या websiteURL नहीं।
अगर आप किसी अन्य API से माइग्रेट कर रहे हैं, तो यह सिर्फ़ फ़ील्ड का नाम बदलना नहीं है। पहले अपने वर्कस्पेस में एक सक्रिय प्रोफ़ाइल सेट अप करें; होस्टनेम, ऐक्शन या साइट कुंजी भेजने से प्रोफ़ाइल नहीं बनती।
इस पेज पर
कंसोल में साइट कुंजी और पेज कॉन्फ़िगर करें
- 1.
साइट जोड़ें खोलें
साइट प्रोफ़ाइल पर जाएँ और साइट जोड़ें चुनें। टार्गेट का HTTPS पेज URL दर्ज करें। टास्क उसके होस्टनेम का उपयोग करेगा, इस पूरे URL का नहीं। पेज सेटअप के लिए ज़रूरी हो तो वैकल्पिक नेविगेशन URL और Referer मान दें।
- 2.
प्रकार चुनें और साइट कुंजी जाँचें
reCAPTCHA Enterprise इंटीग्रेशन के लिए Enterprise v3 या सामान्य reCAPTCHA v3 के लिए Regular v3 चुनें। फ़ॉर्म साइट कुंजी अपने-आप खोज सकता है; आप वैकल्पिक साइट कुंजी फ़ील्ड में इसे बदलने वाला मान दे सकते हैं।
- 3.
कैप्चर ऐक्शन सेट करें
कैप्चर ऐक्शन ज़रूरी है। नीचे दिए अनुरोध के लिए, कैप्चर ऐक्शन
loginवाली प्रोफ़ाइल कॉन्फ़िगर करें। समीक्षा की गई सिस्टम प्रोफ़ाइल लाइव पुल के बिना ज्ञात पेज सेटअप और कैप्चर ऐक्शन भर सकती हैं; चुने गए ऐक्शन के बारे में फ़ॉर्म में दिया गया विवरण पढ़ें। - 4.
सबमिट करें और सक्रिय होने की प्रतीक्षा करें
साइट जोड़ें चुनें। सबमिशन सक्रिय होने से पहले कतार में, कैप्चर, सत्यापन या समीक्षा की स्थितियों से गुज़र सकते हैं; कैप्चर की अवधि की कोई गारंटी नहीं है। कुछ खातों में जारी रखने के लिए क्रेडिट जोड़ें दिखता है। अगर कैप्चर विफल हो, तो दोबारा प्रयास करने से पहले उसका कारण जाँचें।
हर होस्टनेम, कैप्चर ऐक्शन और reCAPTCHA प्रकार के लिए एक प्रोफ़ाइल का उपयोग करें। निष्पादन ऐक्शन का सटीक मिलान उसकी प्रोफ़ाइल चुनता है। अन्य निष्पादन ऐक्शन के लिए एक स्पष्ट कैप्चर टार्गेट ज़रूरी है, इसलिए यह न मानें कि किसी होस्टनेम की एक प्रोफ़ाइल हर ऐक्शन को कवर करती है।
फ़्लैट टास्क अनुरोध भेजें
प्रोफ़ाइल सक्रिय होने पर, इस ऑब्जेक्ट को सीधे JSON बॉडी के रूप में POST /v1/tasks पर भेजें। Authorization: Bearer के बाद अपनी वर्कस्पेस API कुंजी देकर प्रमाणित करें और उस कुंजी को सर्वर पर रखें।
{
"site": "accounts.example.com",
"action": "login",
"proxy": "http://user:[email protected]:8080",
"requestId": "example_login_001"
}siteहोस्टनेम है: इसमें स्कीम, पाथ या क्वेरी नहीं होती। पूरा पेज URL कंसोल प्रोफ़ाइल में दिया जाता है।actionइस टास्क का निष्पादन ऐक्शन है। यहाँloginऊपर कॉन्फ़िगर किए गए कैप्चर ऐक्शन से मेल खाता है।proxyसमाधान के लिए प्रॉक्सी देता है।proxyयाproxyCandidatesमें से ठीक एक ज़रूरी है; दोनों न भेजें।requestIdवैकल्पिक है। अगर टास्क बनाते समय टाइमआउट हो जाए, तो उसी ID के साथ वही अनुरोध दोबारा भेजने पर मौजूदा टास्क लौटता है। उसी ID का दोबारा उपयोग करते हुए टास्क इनपुट बदलने से कॉन्फ़्लिक्ट होता है।
पिछले API के अनुरोध ढाँचे से websiteKey, websiteURL, type या url आगे न लाएँ। reCAPTCHA के लिए recaptchaType का डिफ़ॉल्ट enterprise-v3 है, इसलिए उदाहरण में इसे नहीं दिया गया है। Regular v3 में recaptchaType को v3 पर सेट किया जाता है।
स्रोत और API संदर्भ
अपना पहला टास्क चलाएँ।
$5 वर्कस्पेस क्रेडिट के साथ शुरुआत करें।