আপনার পণ্যে বৈধ অ্যাসেসমেন্ট এম্বেড করুন।

এটি JobCannon অ্যাসেসমেন্ট ইঞ্জিনকে একটি প্রোগ্রামযোগ্য পরিষেবা হিসাবে প্রকাশ করে যা আপনার পণ্য কল করতে পারে। আপনার ব্যবহারকারীরা আপনার নিজস্ব অ্যাপের মধ্যে একটি বৈধ অ্যাসেসমেন্ট — RIASEC, Big Five, EQ, Skills Audit, অথবা 201+ ইনস্ট্রুমেন্টের যেকোনো একটি — গ্রহণ করেন এবং আপনি একটি স্কোর করা ফলাফল ফেরত পান। সম্পূর্ণ লুপটি তিনটি REST কল নিয়ে গঠিত: POST /api/v1/assessments একটি সেশন শুরু করে এবং প্রশ্ন সেট ফেরত দেয়; GET /api/v1/assessments/{session_id}/questions আপনার প্রয়োজন হলে সেই প্রশ্নগুলি পুনরায় ফেচ করে; POST /api/v1/assessments/{session_id}/complete উত্তর জমা দেয়, সার্ভার-সাইডে স্কোর করে এবং ফলাফল ফেরত দেয়। কনজিউমার পণ্য যে স্কোরিং কোড পাথ ব্যবহার করে (lib/scoring/compute.ts) সেটি API এর পিছনে চলে, তাই একটি API ফলাফল jobcannon.io-তে নেওয়া ফলাফলের মতোই হয়।

প্রতিটি অনুরোধে একটি X-API-Key হেডার থাকে। আপনার কীটি jck_live_… এর মতো দেখতে এবং এটি প্রতিটি প্রতিষ্ঠানের জন্য স্কোপ সহ ইস্যু করা হয় — assessments:send আপনাকে সেশন শুরু এবং সম্পূর্ণ করতে দেয়, assessments:read আপনাকে প্রশ্নগুলি পুনরায় আনতে দেয়। কীগুলি SHA-256 হ্যাশ করা থাকে এবং কখনও প্লেইনটেক্সটে সংরক্ষণ করা হয় না। এখানে কোনো OAuth ডান্স বা ক্লায়েন্ট-সিক্রেট এক্সচেঞ্জ নেই: একটি হেডার, স্কোপড, বাতিলযোগ্য। একটি সেশন হল একটি স্বল্পস্থায়ী স্বাক্ষরিত টোকেন যা স্টার্ট কল দ্বারা ফেরত আসে, তাই আপনার দিকে পরিচালনা করার জন্য কোনো সেশন টেবিল নেই এবং কোনো পোলিংও নেই।

POST /api/v1/assessments — বডি { test, locale?, external_user_id?, pool? }; ফেরত দেয় { session_id, test, locale, question_pool, total_questions, questions[] }। GET /api/v1/assessments/{session_id}/questions — একটি চলমান সেশনের জন্য প্রশ্ন পেলোড পুনরায় পরিবেশন করে (স্কোপ assessments:read)। POST /api/v1/assessments/{session_id}/complete — বডি { answers: number[], external_user_id? } যেখানে উত্তরগুলি প্রশ্নগুলি পরিবেশন করার ক্রম অনুসারে বিকল্প সূচক; ফেরত দেয় { result_id, test, top_result, scores, question_pool }। স্কোরিংয়ের আগে উত্তরগুলি দৈর্ঘ্য এবং অবক্ষয়িত/অস্পৃষ্ট ভেক্টরগুলির জন্য যাচাই করা হয়। পুলড ইনস্ট্রুমেন্টগুলি (যেমন IQ ব্যাটারি) পরিবেশিত প্রশ্ন পুলকে সঠিক স্কোরিং কী-এর মাধ্যমে থ্রেড করে।

প্রতিটি সম্পূর্ণ করা অ্যাসেসমেন্ট আপনার প্রতিষ্ঠানে সংরক্ষিত হয় — ফলাফলের সারিটি আপনার api_org_id দিয়ে লেখা হয়, তাই এটি আপনার কাছে আরোপিত হয়, কোনো বেনামী ব্রাউজার সেশন বা JobCannon গ্রাহক অ্যাকাউন্টের কাছে নয়। সম্পূর্ণ কলটি result_id, top_result (সেই ইনস্ট্রুমেন্টের জন্য প্রধান আর্কিটাইপ/টাইপ/কোড), এবং সম্পূর্ণ প্রতি-মাত্রার স্কোর ফেরত দেয়। আপনি result_id সংরক্ষণ করেন এবং আপনার পণ্যের মধ্যে ফলাফলটি আপনার পছন্দ মতো রেন্ডার করেন। বর্তমান v1 স্কোর করা ফলাফল ফেরত দেয়; সমৃদ্ধ AI Career Guide বর্ণনা (কোর্স সুপারিশ, ২,৫২১-ক্যারিয়ার ম্যাপিং) একটি পৃথক গ্রাহক পৃষ্ঠ এবং এটি প্রতিটি অংশীদারের জন্য স্কোপ করা হয়, এটি একটি ডিফল্ট v1 প্রতিক্রিয়া নয়।

অনুরোধগুলি প্রতি API কী (কী পরিচয়, কলকারী IP নয়) অনুযায়ী রেট-লিমিটেড হয়, তাই একটি গোলমালপূর্ণ ইন্টিগ্রেশন অন্যটিকে কখনও অনাহারে রাখে না। সীমা অতিক্রম করলে আপনি বডিতে একটি resetAt টাইমস্ট্যাম্প সহ একটি HTTP 429 পাবেন — কোনো নীরব থ্রটলিং নেই, কোনো অনুরোধ বাদ পড়ে না। প্রতিটি স্টার্ট এবং কমপ্লিট কল পরিমাপ করা হয় যাতে বিলিংয়ের জন্য আপনার মাসিক অ্যাসেসমেন্ট গণনা সঠিক হয়।

যে দলগুলি ইন-হাউস ক্যারিয়ার-অ্যাসেসমেন্ট তৈরি করে তারা সাধারণত দুটি খরচকে অবমূল্যায়ন করে। (1) যাচাইকৃত আইটেম ব্যাংক এবং স্কোরিং — আপনার নিজের তৈরি এবং যাচাই করতে বছর এবং হাজার হাজার প্রশাসন লাগে। (2) রক্ষণাবেক্ষণ — ইনস্ট্রুমেন্টগুলি পরিবর্তিত হয় এবং আইটেম ব্যাংকগুলির রিফ্রেশ প্রয়োজন। API হল শর্টকাট: আপনি তিনটি এন্ডপয়েন্ট কল করেন, আমরা সাইকোমেট্রিক্সকে আপ-টু-ডেট রাখি। এটি স্কেল টায়ারে ($199/mo) লাইভ আছে, যার মধ্যে একটি মাসিক অ্যাসেসমেন্ট বরাদ্দ অন্তর্ভুক্ত। ক্যাপ অ্যাসেসমেন্ট গণনা করে: আপনি যে প্রতিটি ইনস্ট্রুমেন্ট বরাদ্দ করেন তা একটি ইউনিট খরচ করে। হোয়াইট-লেবেল অংশীদার যারা আমাদের অ্যাসেসমেন্টগুলি পুনরায় বিক্রি করে তারা এর পরিবর্তে রাজস্ব-শেয়ারে যেতে পারে।