डॉक्सक्वालिफ़िकेशन टेस्ट
बाहरी क्वालिफ़िकेशन टेस्ट
आप अपना क्वालिफ़िकेशन टेस्ट अपनी वेबसाइट पर चला सकते हैं। वर्कर आपके लिंक पर जाते हैं, और आपका सर्वर TaskerData को बताता है कि कौन पास हुआ।
यह कैसे काम करता है
TaskerData पर आपकी क्वालिफ़िकेशन में सिर्फ़ निर्देश और एक लिंक होता है। हर वर्कर को एक निजी टोकन मिलता है। अपनी साइट पर आप वह टोकन माँगते हैं, अपना टेस्ट चलाते हैं, फिर नतीजे के साथ हमारी API को कॉल करते हैं। वर्कर तुरंत स्वीकृत या अस्वीकृत हो जाता है।
स्टेप 1: क्वालिफ़िकेशन सेट करें
सवाल चुनें
नई क्वालिफ़िकेशन बनाएँ और क्वालिफ़िकेशन का प्रकार सवाल पर ही रहने दें। टेम्पलेट बाहरी सोर्स इस्तेमाल नहीं कर सकते।
कोटेशन एरिया जोड़ें
अपने निर्देश लिखें और अपने टेस्ट का लिंक डालें। वर्कर से कहें कि वे अपना टोकन ID कॉपी करके आपकी साइट पर डालें।
जवाब वाले सवाल न जोड़ें
बाहरी विकल्प सिर्फ़ तभी दिखता है जब किसी सवाल में टेक्स्ट, चेकबॉक्स या रेडियो जवाब न हो और कम से कम एक कोटेशन एरिया में लिंक हो।
बाहरी विकल्प पर टिक करें
क्वालिफ़िकेशन किसी एक्सटर्नल सोर्स से कराएँ पर टिक करें। API लिंक सबमिट करने के बाद दिया जाता है।
वर्कर चुनें और सबमिट करें
हमेशा की तरह टार्गेटिंग और पोज़िशन सेट करें। आप स्वीकार किए गए वर्कर के लिए क्वालिफ़िकेशन बोनस जोड़ सकते हैं।
लागत
बाहरी टेस्ट की लागत सामान्य क्वालिफ़िकेशन जितनी ही है, साथ में $1.00 की एक्सटर्नल सोर्स फ़ीस। जाँचें और सबमिट करें स्टेप पर अनुमानित लागत पूरी कुल रकम दिखाती है।
स्टेप 2: स्वीकृति और सेटअप
हमारी टीम के क्वालिफ़िकेशन स्वीकार करने के बाद (भरोसेमंद रिक्वेस्टर अपने-आप स्वीकृत होते हैं), वह रुकी हुई स्थिति में शुरू होती है। आपको एक मैसेज मिलता है: क्वालिफ़िकेशन स्वीकृत (सेटअप ज़रूरी)। वर्कर अभी उसे नहीं देख सकते।
क्वालिफ़िकेशन खोलें और अपना endpoint देखने के लिए एक्सटर्नल सोर्स और API पर क्लिक करें, जिसमें आपकी क्वालिफ़िकेशन ID और API key भरी होती है। अपना सर्वर सेट करें, फिर लाइव होने के लिए क्वालिफ़िकेशन फिर शुरू करें पर क्लिक करें।
वर्कर टोकन
जब कोई वर्कर आपकी एक्टिव बाहरी क्वालिफ़िकेशन खोलता है, तो TaskerData उसे आपकी टोकन ID दिखाता है। यह टोकन सिर्फ़ उसी वर्कर और उसी क्वालिफ़िकेशन का होता है, और पेज रीलोड करने पर भी वही रहता है। आपकी वेबसाइट को वर्कर से इसे डालने के लिए कहना होगा।
स्टेप 3: नतीजा भेजें
अपने सर्वर से इन query पैरामीटर के साथ https://taskerdata.com/api/worker/external_qualification/data पर GET रिक्वेस्ट भेजें:
| पैरामीटर | विवरण |
|---|---|
| qualification_id | क्वालिफ़िकेशन की ID |
| worker_token | वह टोकन ID जो वर्कर ने आपकी साइट पर डाला |
| api_token | आपकी API key |
| decision | approve या reject |
टिप: API को अपने सर्वर से कॉल करें, वर्कर के ब्राउज़र से नहीं, ताकि आपकी API key गुप्त रहे।
नियम और एरर मैसेज
सफल कॉल पर success true और नया स्टेटस मिलता है। नहीं तो आपको success false और इनमें से कोई एरर मिलता है:
- Missing required parameters: चारों पैरामीटर ज़रूरी हैं।
- Decision must be approve or reject: decision सिर्फ़ approve या reject हो सकता है।
- Invalid API token, या API token does not belong to the qualification owner: key गलत है या टेस्ट के मालिक की नहीं है।
- Worker token not found for this qualification: यह टोकन इस क्वालिफ़िकेशन का नहीं है।
- This qualification is not configured for external submissions: क्वालिफ़िकेशन बाहरी सबमिशन के लिए सेट नहीं है।
- This qualification is no longer active: रुके हुए, पूरे हुए या बंद टेस्ट नतीजे स्वीकार नहीं करते।
- This worker has already been evaluated for this qualification: हर वर्कर का नतीजा एक बार ही भेजा जा सकता है।
- Worker account is suspended: वर्कर का अकाउंट सस्पेंड है।
- No remaining positions for this qualification: इस क्वालिफ़िकेशन में कोई पोज़िशन नहीं बची।
ज़रूरी: अगर आपका बैलेंस स्वीकृत वर्कर के बोनस के लिए काफ़ी नहीं है, तो सबमिशन लंबित के रूप में सेव होता है और जवाब में एक नोट होता है। बैलेंस टॉप अप करें और डैशबोर्ड में उसे स्वीकार करें।
अपना इंटीग्रेशन टेस्ट करना
असली वर्कर पर असर डाले बिना टेस्ट करने के लिए, https://taskerdata.com/api/worker/external_qualification/data_test पर JSON body के साथ POST रिक्वेस्ट भेजें। वही चार फ़ील्ड इस्तेमाल करें, पर api_token में अपनी टेस्ट API Key डालें।
टेस्ट endpoint सिर्फ़ यह जाँचता है कि फ़ील्ड मौजूद हैं, decision approve या reject है, और test key सही है। यह किसी को स्वीकार या अस्वीकार नहीं करता।
API keys
अपने डैशबोर्ड का API सेक्शन खोलें। अपनी API Key बनाने के लिए नई Key बनाएँ पर क्लिक करें, और उसी पेज से अपनी टेस्ट API Key कॉपी करें। आप एक घंटे में 3 तक नई keys बना सकते हैं।
नई key पुरानी key की जगह ले लेती है। अगर आप नई key बनाते हैं, तो अपना सर्वर कोड अपडेट करें, नहीं तो आपकी कॉल Invalid API token एरर के साथ फ़ेल होंगी।
टिप: पूरी तकनीकी जानकारी /docs/api पर API पेज पर है।
आम सवाल
मेरी स्वीकृत क्वालिफ़िकेशन रुकी हुई क्यों है?
बाहरी क्वालिफ़िकेशन रुकी हुई स्थिति में शुरू होती हैं ताकि आप पहले अपना सर्वर सेट कर सकें। तैयार होने पर क्वालिफ़िकेशन फिर शुरू करें पर क्लिक करें।
क्या अस्वीकृत वर्कर पोज़िशन इस्तेमाल करते हैं?
नहीं। सिर्फ़ स्वीकृत और लंबित सबमिशन आपकी पोज़िशन में गिने जाते हैं।
क्या नतीजा भेजने के बाद फ़ैसला बदल सकते हैं?
API हर वर्कर के लिए एक ही नतीजा लेती है। उसी वर्कर के लिए दूसरी कॉल पर एरर मिलता है।