Postman में solvethree का परीक्षण करें
क्रेडेंशियल-रहित Postman कलेक्शन इंपोर्ट करें, निजी एनवायरनमेंट मान कॉन्फ़िगर करें और टास्क बनाएँ अनुरोध एक बार भेजें। फिर उसी टास्क के पूरा होने तक उसे जाँचने के लिए टास्क प्राप्त करें अनुरोध इस्तेमाल करें। कलेक्शन में ऐसे कोई स्वचालित परीक्षण या स्क्रिप्ट नहीं हैं जो अतिरिक्त टास्क सबमिट करें।
इस पेज पर
कलेक्शन इंपोर्ट और कॉन्फ़िगर करें
- 1.
डाउनलोड किया गया JSON इंपोर्ट करें
Postman में, इंपोर्ट चुनें और कलेक्शन फ़ाइल चुनें। इसमें टास्क बनाएँ और टास्क प्राप्त करें अनुरोध हैं, जिनमें इनहेरिट किया गया Bearer प्राधिकरण और वेरिएबल प्लेसहोल्डर हैं।
- 2.
साइट की प्रोफ़ाइल जाँचें
आपके वर्कस्पेस में लक्ष्य होस्टनाम के लिए सक्रिय प्रोफ़ाइल होनी चाहिए। परीक्षण से पहले इसे कंसोल में कॉन्फ़िगर करें; होस्टनाम और ऐक्शन भेजने से प्रोफ़ाइल नहीं बनती। साइट प्रोफ़ाइल सेटअप देखें।
- 3.
निजी एनवायरनमेंट मान कॉन्फ़िगर करें
इस परीक्षण के लिए एनवायरनमेंट बनाएँ और चुनें। किसी भी प्रॉक्सी क्रेडेंशियल सहित नीचे दिए गए मान निजी रूप से भरें। सीक्रेट सीधे कलेक्शन में न रखें और न ही भरे हुए सीक्रेट एक्सपोर्ट करें।
- 4.
Bearer प्राधिकरण कॉन्फ़िगर करें
कलेक्शन स्तर पर Bearer Token चुनें और अपनी वर्कस्पेस API कुंजी वाले निजी एनवायरनमेंट वेरिएबल का संदर्भ दें। दोनों अनुरोधों को प्राधिकरण इनहेरिट करने पर सेट रहने दें। API को Authorization: Bearer के बाद वह कुंजी चाहिए।
| वेरिएबल | क्या दर्ज करें |
|---|---|
| SOLVETHREE_API_KEY | आपकी निजी वर्कस्पेस API कुंजी। कलेक्शन का Bearer टोकन इस वेरिएबल का संदर्भ देता है। |
| SITE | लक्ष्य होस्टनाम, पूरा पेज URL नहीं। |
| ACTION | लक्ष्य अनुरोध द्वारा इस्तेमाल किया जाने वाला reCAPTCHA ऐक्शन। |
| PROXY | इस परीक्षण के लिए HTTP या HTTPS प्रॉक्सी URL, ज़रूरत होने पर क्रेडेंशियल सहित। |
| REQUEST_ID | हर नए तार्किक टास्क के लिए नया मान: 1–64 ASCII अक्षर, अंक, अंडरस्कोर या हाइफ़न। |
| TASK_ID | शुरुआत में खाली छोड़ें। टास्क बनने के बाद लौटाया गया id यहाँ कॉपी करें। |
टास्क बनाएँ अनुरोध एक बार भेजें
टास्क बनाएँ खोलें। यह https://api.solvethree.com/v1/tasks पर POST भेजता है, जिसकी रॉ JSON बॉडी आपके चुने गए एनवायरनमेंट से भरी जाती है।
{
"site": "{{SITE}}",
"action": "{{ACTION}}",
"proxy": "{{PROXY}}",
"requestId": "{{REQUEST_ID}}"
}यह अनुरोध डिफ़ॉल्ट रूप से reCAPTCHA Enterprise v3 इस्तेमाल करता है। type या url फ़ील्ड न जोड़ें। इसमें एक proxy दिया जाता है, इसलिए साथ में proxyCandidates न जोड़ें: उन फ़ील्ड में से ठीक एक आवश्यक है।
भेजने से पहले REQUEST_ID सेट करें, फिर भेजें पर एक बार क्लिक करें। पहले HTTP रिस्पॉन्स जाँचें। अगर वह असफल है, तो बॉडी को सफल टास्क रिस्पॉन्स मानने के बजाय अनुरोध की त्रुटि जाँचें। अमान्य इनपुट को बार-बार बिना बदले भेजने के बजाय ठीक करें।
टास्क बनाने का सफल रिस्पॉन्स मिलने पर, लौटाए गए id को अपने निजी TASK_ID एनवायरनमेंट मान में कॉपी करें। केवल प्रगति जाँचने के लिए टास्क बनाएँ पर दोबारा क्लिक न करें।
मौजूदा टास्क प्राप्त करें
टास्क प्राप्त करें खोलें और पुष्टि करें कि TASK_ID में लौटाई गई टास्क ID है। यह अनुरोध उसी API पर GET /v1/tasks/:id इस्तेमाल करता है। इसे मैन्युअल रूप से भेजें, HTTP रिस्पॉन्स जाँचें, फिर टास्क की status जाँचें।
| स्थिति | अगली कार्रवाई |
|---|---|
| pending या solving | टास्क अभी पूरा नहीं हुआ है। प्रतीक्षा करें, फिर उसी TASK_ID के साथ टास्क प्राप्त करें अनुरोध दोबारा भेजें। |
| तैयार | प्राप्त करना बंद करें। टास्क में इस्तेमाल करने योग्य समाधान है। |
| failed | प्राप्त करना बंद करें। क्या बदलना है, यह तय करने के लिए errorCode और error जाँचें। विफल समाधान प्रयासों का शुल्क वापस मिलता है। |
केवल HTTP 200 या 201 का मतलब समाधान तैयार होना नहीं है; केवल status: ready का यही मतलब है। यह मैन्युअल परीक्षण टास्क बनाने और प्राप्त करने की जाँच करता है, यह नहीं कि लक्ष्य वेबसाइट परिणाम स्वीकार करती है या नहीं।
अगर आप आगे reCAPTCHA टोकन को उसके निर्धारित लक्ष्य पर सबमिट करते हैं, तो लौटाई गई userAgent और secChUa ब्राउज़र पहचान तथा सफल प्रॉक्सी इस्तेमाल करें। IP न बदलें और किसी असंबंधित ब्राउज़र पहचान को न मिलाएँ। तैयार टोकन को भी लक्ष्य अस्वीकार कर सकता है।
अगर टास्क बनाएँ अनुरोध टाइमआउट हो जाए
कनेक्शन टाइमआउट से यह साबित नहीं होता कि टास्क बनाना विफल हुआ। अगर आपके पास टास्क ID है, तो उसे प्राप्त करें। अगर आपको ID मिली ही नहीं, तो उसी REQUEST_ID और बिना बदले टास्क इनपुट के साथ टास्क बनाएँ अनुरोध फिर से भेजें। इससे नया तार्किक टास्क बनाने के बजाय मौजूदा टास्क रिकवर होता है।
केवल रिस्पॉन्स खो जाने के कारण नया REQUEST_ID न बनाएँ। अलग टास्क इनपुट के साथ ID दोबारा इस्तेमाल करने पर टकराव होता है; नई ID तब इस्तेमाल करें जब आप जानबूझकर नया टास्क शुरू करें।
स्रोत और API संदर्भ
अपना पहला टास्क चलाएँ।
$5 वर्कस्पेस क्रेडिट के साथ शुरुआत करें।