cURL से reCAPTCHA Enterprise टोकन का अनुरोध करें

• सुनिश्चित करें कि आपके शेल में cURL और jq उपलब्ध हैं।
• SOLVETHREE_API_KEY को अपनी वर्कस्पेस API कुंजी पर सेट करें। ये कमांड सर्वर पर चलाएँ; कुंजी को ब्राउज़र कोड में न रखें।
• SOLVETHREE_PROXY को उस प्रॉक्सी URL पर सेट करें जिसे आप हल करने और टोकन सबमिट करने के लिए इस्तेमाल करना चाहते हैं।
• कंसोल में अपने वर्कस्पेस के लिए सक्रिय reCAPTCHA साइट प्रोफ़ाइल सेट अप करें। उदाहरण में 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 @-

JSON बॉडी में site, action और एक proxy दिया जाता है। proxy या proxyCandidates में से ठीक एक ज़रूरी है। type या url न जोड़ें; recaptchaType छोड़ने पर enterprise-v3 चुना जाता है।

waitMs=15000 क्वेरी पैरामीटर टास्क बनाने वाले अनुरोध को 15 सेकंड तक इंतज़ार करने के लिए कहता है। यह URL में जाता है, JSON बॉडी में नहीं। cURL टाइमआउट 30 सेकंड है, जिससे सर्वर पर होने वाले उस इंतज़ार के अलावा नेटवर्क ओवरहेड के लिए भी समय मिलता है। रिस्पॉन्स आने पर भी टास्क अंतिम स्थिति तक न पहुँचा हो सकता है।

बॉडी को टास्क रिस्पॉन्स मानने से पहले HTTP त्रुटि जाँचें। दोनों कमांड --fail-with-body इस्तेमाल करते हैं; विफल HTTP अनुरोध को उस टास्क से अलग सँभालें जिसका स्टेटस failed है।

तैयार रिस्पॉन्स का यह स्वरूप होता है। नीचे दिए गए मान प्लेसहोल्डर हैं, सबमिट करने योग्य टोकन नहीं।

{
  "id": "example-task",
  "status": "ready",
  "solution": {
    "token": "EXAMPLE_TOKEN",
    "userAgent": "EXAMPLE_USER_AGENT",
    "secChUa": "EXAMPLE_CLIENT_HINTS"
  }
}

अगर रिस्पॉन्स अंतिम स्थिति में नहीं है, तो अपने एनवायरनमेंट में TASK_ID को लौटाई गई id पर सेट करें, फिर टास्क प्राप्त करें:

curl --fail-with-body --max-time 30 \
  "https://api.solvethree.com/v1/tasks/$TASK_ID?waitMs=15000" \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY"

यह GET परिणाम के लिए 15 सेकंड तक इंतज़ार करता है और इसका HTTP टाइमआउट 30 सेकंड है। waitMs के बिना GET इंतज़ार किए बिना लौटता है। GET केवल तब तक दोहराएँ जब तक स्टेटस pending या solving है, और कॉल करने वाले कोड में कुल समय-सीमा तय करें ताकि पोलिंग लूप अनिश्चित काल तक न चलता रहे।

अगर टास्क विफल हो, तो क्रेडिट की समस्या मान लेने के बजाय उसकी त्रुटि का विवरण इस्तेमाल करें। उदाहरण के लिए, site-unreachable आने पर लक्ष्य तक पहुँच की जाँच करनी चाहिए, न कि बिना बदलाव के वही इनपुट आँख मूँदकर दोबारा भेजने चाहिए।

लक्षित एप्लिकेशन के अनुरोध में solution.token का उपयोग करें। टास्क का id केवल टास्क प्राप्त करने के लिए है; यह CAPTCHA टोकन नहीं है। टोकन कहाँ देना है, यह लक्ष्य के फ़ॉर्म या API पर निर्भर करता है, इसलिए लक्ष्य पर सबमिट करने के लिए कोई सार्वभौमिक कमांड नहीं है।

टोकन सबमिट करते समय लौटाए गए solution.userAgent और solution.secChUa के साथ सफल प्रॉक्सी का उपयोग करें। ऊपर दिए गए एकल-प्रॉक्सी उदाहरण में उसी SOLVETHREE_PROXY का उपयोग करें। किसी असंबंधित ब्राउज़र पहचान या लक्ष्य URL को इसमें न मिलाएँ।

ready का अर्थ है कि solvethree ने समाधान जनरेट कर दिया है। लक्ष्य एप्लिकेशन ने आपका अनुरोध स्वीकार किया या नहीं, यह जानने के लिए उसकी प्रतिक्रिया अलग से जाँचें।