اپنی پروڈکٹ میں تصدیق شدہ تشخیصات شامل کریں۔

یہ JobCannon کے تشخیصی انجن کو ایک پروگرام ایبل سروس کے طور پر پیش کرتا ہے جسے آپ کی پروڈکٹ کال کر سکتی ہے۔ آپ کے صارفین ایک تصدیق شدہ تشخیص لیتے ہیں — RIASEC، Big Five، EQ، Skills Audit، یا 195+ آلات میں سے کوئی بھی — آپ کی اپنی ایپ کے اندر، اور آپ کو ایک اسکور شدہ نتیجہ واپس ملتا ہے۔ مکمل لوپ تین 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 کا پیچیدہ عمل ہے، نہ کلائنٹ سیکرٹ کا تبادلہ: صرف ایک ہیڈر، دائرہ کار میں محدود، اور منسوخ کیا جا سکنے والا۔ سیشن ایک مختصر مدت کا دستخط شدہ ٹوکن ہوتا ہے جو start کال سے واپس ملتا ہے، اس لیے آپ کی جانب نہ کوئی سیشن ٹیبل منظم کرنی پڑتی ہے، نہ پولنگ کرنی پڑتی ہے۔

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 — جاری سیشن کے لیے سوالات کا payload دوبارہ فراہم کرتا ہے (اسکوپ assessments:read)۔ POST /api/v1/assessments/{session_id}/complete — باڈی { answers: number[], external_user_id? } جہاں جوابات وہی ترتیب میں آپشن انڈیکس ہوتے ہیں جس ترتیب میں سوالات دیے گئے تھے؛ یہ { result_id, test, top_result, scores, question_pool } واپس دیتا ہے۔ اسکورنگ سے پہلے جوابات کی لمبائی اور کسی بھی غیرمتحرک/ناقص ویکٹر کی جانچ کی جاتی ہے۔ پول کیے گئے آلات (مثلاً IQ بیٹری) دیے گئے سوالات کے پول کو درست اسکورنگ کلید تک پہنچاتے ہیں۔

ہر مکمل شدہ اسیسمنٹ آپ کی تنظیم کے تحت محفوظ کی جاتی ہے — نتیجے کی row آپ کے api_org_id کے ساتھ لکھی جاتی ہے، اس لیے یہ آپ سے منسوب ہوتی ہے، نہ کہ کسی گمنام براؤزر سیشن یا JobCannon کے کنزیومر اکاؤنٹ سے۔ complete کال result_id، top_result (اس انسٹرومنٹ کا بنیادی آرکی ٹائپ/قسم/کوڈ) اور ہر ڈائمینشن کے مکمل اسکورز واپس کرتی ہے۔ آپ result_id کو محفوظ کرتے ہیں اور اپنے پروڈکٹ کے اندر نتیجہ جیسے چاہیں دکھاتے ہیں۔ موجودہ v1 صرف اسکور شدہ نتیجہ واپس کرتا ہے؛ زیادہ تفصیلی AI Career Guide بیانیہ (کورس تجاویز، 2,521-کیریئر میپنگ) ایک الگ کنزیومر سرفیس ہے اور فی پارٹنر scope کیا جاتا ہے — یہ v1 کا ڈیفالٹ ریسپانس نہیں ہے۔

درخواستیں ہر API key کے حساب سے ریٹ لمیٹڈ ہوتی ہیں (کالر کے IP کی بجائے key کی شناخت کی بنیاد پر)، اس لیے ایک شور مچانے والا انٹیگریشن کبھی دوسرے کو متاثر نہیں کرتا۔ حد سے تجاوز پر آپ کو باڈی میں resetAt ٹائم اسٹیمپ کے ساتھ HTTP 429 موصول ہوتا ہے — نہ کوئی خاموش تھروٹلنگ، نہ کوئی گمشدہ درخواست۔ ہر start اور complete کال میٹر کی جاتی ہے تاکہ آپ کی ماہانہ اسیسمنٹ گنتی بلنگ کے لیے درست رہے۔

جو ٹیمیں کیریئر اسیسمنٹ خود اپنے ادارے کے اندر بناتی ہیں وہ عام طور پر دو لاگتوں کو کم سمجھتی ہیں۔ (1) تصدیق شدہ آئٹم بینکس اور اسکورنگ — RIASEC، Big Five اور EQ فریم ورکس عوامی ہیں، لیکن تصدیق شدہ آئٹم پولز اور ڈائریکشنل اسکورنگ الگورتھمز عوامی نہیں؛ اپنے طور پر بنانے اور تصدیق کرنے میں سالوں کا وقت اور دسیوں ہزار بار ٹیسٹ کروانے کی ضرورت پڑتی ہے۔ (2) دیکھ بھال — انسٹرومنٹس وقت کے ساتھ drift کرتے ہیں اور آئٹم بینکس کو تازہ کاری درکار ہوتی ہے۔ API ایک شارٹ کٹ ہے: آپ صرف تین اینڈ پوائنٹس کال کرتے ہیں، سائیکومیٹرکس کو اپ ٹو ڈیٹ رکھنا ہمارا کام ہے۔ یہ Scale ٹیئر ($199/mo) پر دستیاب ہے، جس میں ماہانہ اسیسمنٹ الاٹمنٹ شامل ہے۔ حد اسیسمنٹس گنتی ہے: آپ جو بھی انسٹرومنٹ اسائن کرتے ہیں وہ ایک یونٹ خرچ کرتا ہے۔ ہمارے اسیسمنٹس دوبارہ فروخت کرنے والے White-Label پارٹنرز اس کی بجائے ریونیو شیئر پر منتقل ہو سکتے ہیں۔