ডকসকোয়ালিফিকেশন টেস্ট
এক্সটার্নাল কোয়ালিফিকেশন টেস্ট
আপনার কোয়ালিফিকেশন টেস্ট নিজের ওয়েবসাইটে চালাতে পারেন। ওয়ার্কাররা আপনার লিংকে যান, আর আপনার সার্ভার TaskerData-কে জানায় কে পাস করেছেন।
কীভাবে কাজ করে
TaskerData-তে আপনার কোয়ালিফিকেশনে শুধু নির্দেশনা আর একটি লিংক থাকে। প্রত্যেক ওয়ার্কার একটি ব্যক্তিগত টোকেন পান। আপনার সাইটে আপনি সেই টোকেন চান, টেস্ট চালান, তারপর ফলাফলসহ আমাদের API কল করেন। ওয়ার্কার সঙ্গে সঙ্গে অনুমোদিত বা প্রত্যাখ্যাত হন।
ধাপ 1: কোয়ালিফিকেশন সেট আপ করুন
“প্রশ্ন” বেছে নিন
নতুন কোয়ালিফিকেশন তৈরি করুন এবং কোয়ালিফিকেশনের ধরন “প্রশ্ন”-তেই রাখুন। টেমপ্লেটে এক্সটার্নাল সোর্স ব্যবহার করা যায় না।
একটি কোটেশন এরিয়া যোগ করুন
আপনার নির্দেশনা লিখুন এবং টেস্টের লিংক দিন। ওয়ার্কারদের বলুন তাদের টোকেন ID কপি করে আপনার সাইটে দিতে।
উত্তরের প্রশ্ন যোগ করবেন না
এক্সটার্নাল অপশন তখনই দেখা যায় যখন কোনো প্রশ্নে টেক্সট, চেকবক্স বা রেডিও উত্তর নেই এবং অন্তত একটি কোটেশন এরিয়ায় লিংক আছে।
এক্সটার্নাল অপশনে টিক দিন
“এক্সটার্নাল সোর্সের মাধ্যমে কোয়ালিফিকেশন নিন” টিক দিন। সাবমিট করার পর API লিংক দেওয়া হয়।
ওয়ার্কার বেছে নিয়ে সাবমিট করুন
যথারীতি টার্গেটিং ও পজিশন সেট করুন। অনুমোদিত ওয়ার্কারদের জন্য “কোয়ালিফিকেশন বোনাস” যোগ করতে পারেন।
খরচ
এক্সটার্নাল টেস্টের খরচ সাধারণ কোয়ালিফিকেশনের মতোই, সাথে $1.00 “এক্সটার্নাল সোর্স ফি”। “দেখে জমা দিন” ধাপে “আনুমানিক খরচ”-এ পুরো মোট পরিমাণ দেখায়।
ধাপ 2: অনুমোদন ও সেটআপ
আমাদের টিম কোয়ালিফিকেশন অনুমোদন করার পর (বিশ্বস্ত রিকোয়েস্টাররা স্বয়ংক্রিয়ভাবে অনুমোদন পান), এটি বিরতি অবস্থায় শুরু হয়। আপনি একটি মেসেজ পাবেন: Qualification Approved (Setup Required), অর্থাৎ অনুমোদিত, তবে সেটআপ বাকি। ওয়ার্কাররা এখনও এটি দেখতে পান না।
কোয়ালিফিকেশনটি খুলে “এক্সটার্নাল সোর্স ও API” ক্লিক করুন, সেখানে আপনার কোয়ালিফিকেশন ID ও API key বসানো অবস্থায় এন্ডপয়েন্ট দেখতে পাবেন। আপনার সার্ভার সেট আপ করুন, তারপর লাইভ করতে “কোয়ালিফিকেশন আবার চালু করুন” ক্লিক করুন।
ওয়ার্কার টোকেন
কোনো ওয়ার্কার আপনার সক্রিয় এক্সটার্নাল কোয়ালিফিকেশন খুললে TaskerData তাকে “আপনার টোকেন ID” দেখায়। টোকেনটি শুধু সেই ওয়ার্কার ও সেই কোয়ালিফিকেশনের, এবং পেজ রিলোড করলেও একই থাকে। আপনার ওয়েবসাইটকে ওয়ার্কারের কাছে এটি চাইতে হবে।
ধাপ 3: ফলাফল জানান
আপনার সার্ভার থেকে এই কোয়েরি প্যারামিটারগুলোসহ 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 বডিসহ একটি POST রিকোয়েস্ট পাঠান। একই চারটি ফিল্ড ব্যবহার করুন, তবে api_token-এ আপনার টেস্ট API Key দিন।
টেস্ট এন্ডপয়েন্ট শুধু যাচাই করে যে ফিল্ডগুলো আছে, decision হলো approve বা reject, এবং টেস্ট key বৈধ। এটি কাউকে অনুমোদন বা প্রত্যাখ্যান করে না।
API key
আপনার ড্যাশবোর্ডের API সেকশন খুলুন। আপনার API Key তৈরি করতে “নতুন Key তৈরি করুন” ক্লিক করুন, এবং একই পেজ থেকে আপনার টেস্ট API Key কপি করুন। প্রতি ঘণ্টায় সর্বোচ্চ 3টি নতুন key তৈরি করতে পারবেন।
নতুন key পুরোনোটিকে বাতিল করে দেয়। নতুন key তৈরি করলে আপনার সার্ভার কোড আপডেট করুন, না হলে কলগুলো Invalid API token এরর দিয়ে ব্যর্থ হবে।
টিপ: সম্পূর্ণ টেকনিক্যাল বিবরণ /docs/api এর API পেজে আছে।
সাধারণ প্রশ্ন
আমার অনুমোদিত কোয়ালিফিকেশন বিরতিতে কেন?
এক্সটার্নাল কোয়ালিফিকেশন বিরতি অবস্থায় শুরু হয়, যাতে আপনি আগে সার্ভার সেট আপ করতে পারেন। প্রস্তুত হলে “কোয়ালিফিকেশন আবার চালু করুন” ক্লিক করুন।
প্রত্যাখ্যাত ওয়ার্কাররা কি পজিশন খরচ করেন?
না। শুধু অনুমোদিত ও অপেক্ষমাণ সাবমিশন আপনার পজিশনে গণনা হয়।
ফলাফল জানানোর পর কি সিদ্ধান্ত বদলাতে পারব?
API প্রতি ওয়ার্কারের জন্য একটি ফলাফলই নেয়। একই ওয়ার্কারের জন্য দ্বিতীয়বার কল করলে এরর আসে।