अपनी solvethree API कुंजी बनाएँ और इस्तेमाल करें

1. 1.

   API कुंजियाँ खोलें

   कंसोल में, इच्छित वर्कस्पेस में /api-keys पर API कुंजियाँ खोलें।

2. 2.

   कुंजी को नाम दें

   API कुंजी बनाएँ चुनें। कुंजी का नाम फ़ील्ड में ऐसा नाम दर्ज करें जिससे आपको पहचानने में मदद मिले कि आप इसे कहाँ इस्तेमाल करेंगे, फिर कुंजी बनाएँ चुनें।

3. 3.

   पूरा सीक्रेट कॉपी करें

   अपनी API कुंजी सहेजें के अंतर्गत, सीक्रेट कॉपी करें और अपने सर्वर एप्लिकेशन के लिए उसे सुरक्षित रूप से रखें। यह केवल एक बार दिखाया जाता है।

4. 4.

   डायलॉग बंद करें

   सीक्रेट सहेजने के बाद ही मैंने यह कुंजी सहेज ली है चुनें।

अनुरोधों के प्रमाणीकरण के लिए Authorization: Bearer के बाद पूरी वर्कस्पेस कुंजी दें। इसे ब्राउज़र-साइड कोड से बाहर रखें।

नीचे दिए उदाहरण के लिए, सर्वर एनवायरनमेंट में SOLVETHREE_API_KEY को अपने सीक्रेट पर और SOLVETHREE_PROXY को अपने प्रॉक्सी URL पर सेट करें। accounts.example.com और login की जगह अपने लक्ष्य का होस्टनेम और ऐक्शन दें। लक्ष्य साइट की सक्रिय प्रोफ़ाइल इस वर्कस्पेस में पहले से उपलब्ध होनी चाहिए; उसका होस्टनेम भेजने से प्रोफ़ाइल नहीं बनती। अगर आपने इसे कॉन्फ़िगर नहीं किया है, तो साइट प्रोफ़ाइल सेटअप देखें।

# Set SOLVETHREE_API_KEY and SOLVETHREE_PROXY in your environment first.
# Replace the hostname and action with your active site profile.
jq -n \
  --arg proxy "$SOLVETHREE_PROXY" \
  --arg requestId "login-$(date +%s)-$$" \
  '{site:"accounts.example.com", action:"login", proxy:$proxy, requestId:$requestId}' \
| curl --fail-with-body --max-time 30 \
  'https://api.solvethree.com/v1/tasks?waitMs=15000' \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @-

यह सार्वजनिक API को टास्क बनाने का अनुरोध भेजता है। यह केवल प्रमाणीकरण की जाँच नहीं, बल्कि वास्तव में CAPTCHA हल करने का टास्क बनाता है: ready टास्क का शुल्क लगता है। केवल सफल HTTP प्रतिक्रिया का अर्थ यह नहीं है कि टास्क तैयार है या लक्ष्य वेबसाइट उसका समाधान स्वीकार करेगी।

API HTTP 401 लौटाता है।

सर्वर का Authorization हेडर जाँचें। उसमें Bearer के बाद पूरा सीक्रेट होना चाहिए, कुंजी का नाम या दिखाया गया प्रीफ़िक्स नहीं। जाँचें कि कुंजी रद्द तो नहीं की गई है।

यह आज़माएँ: हेडर ठीक करें या रद्द की गई कुंजी की जगह नई कुंजी दें और अपना सर्वर कॉन्फ़िगरेशन अपडेट करें। टास्क पेलोड पढ़ने का प्रयास करने से पहले असफल HTTP प्रतिक्रिया संभालें।

कुंजी से प्रमाणीकरण हो जाता है, लेकिन इच्छित साइट प्रोफ़ाइल उपलब्ध नहीं है।

पुष्टि करें कि कुंजी किस वर्कस्पेस की है और क्या उस वर्कस्पेस में लक्ष्य साइट की सक्रिय प्रोफ़ाइल है। दूसरे वर्कस्पेस की मान्य कुंजी सभी वर्कस्पेस के लिए क्रेडेंशियल नहीं है।

यह आज़माएँ: इच्छित प्रोफ़ाइल वाले वर्कस्पेस की कुंजी इस्तेमाल करें, या अपने उपयोग वाले वर्कस्पेस में प्रोफ़ाइल सेट अप करें। अनुरोध में होस्टनेम बदलने से प्रोफ़ाइल नहीं बनेगी।

अन्य अनुरोध और टास्क विफलताओं के लिए, CAPTCHA API त्रुटियाँ देखें।