په خپل محصول کې تایید شوې ازموینې ځای پر ځای کړئ.

دا د JobCannon د ارزونې انجن د یو پروګرام وړ خدمت په توګه وړاندې کوي چې ستاسو محصول یې کارولی شي. ستاسو کاروونکي ستاسو په خپل اپلیکیشن کې یوه تایید شوې ارزونه — RIASEC، Big Five، EQ، د مهارتونو پلټنه، یا د 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 مسلکي لارښود بډایه کیسه (د کورس سپارښتنې، د ۲٬۵۲۱-مسلک نقشه کول) یو جلا مصرف کونکي سطح دی او د هر ملګري لپاره محدود دی، نه د v1 ډیفالټ ځواب.

غوښتنې د هر API کیلي له مخې د نرخ محدودیت لري (د کیلي هویت، نه د غوښتونکي IP)، نو یو شور لرونکی ادغام هیڅکله بل نه محروموي. د حد څخه پورته تاسو یو HTTP 429 د resetAt ټایم سټیمپ سره په باډي کې ترلاسه کوئ — هیڅ پټ محدودیت نشته، هیڅ غورځول شوې غوښتنه نشته. هره پیل او بشپړه غوښتنه اندازه کیږي نو ستاسو د میاشتنۍ ارزونې شمیر د بیلینګ لپاره دقیق وي.

هغه ټیمونه چې په کور دننه د مسلکي ارزونې سیسټم جوړوي معمولا دوه لګښتونه کم اټکلوي. (1) تایید شوي توکي بانکونه او نمرې ورکول — د خپل ځان جوړول او تاییدول کلونه او لسګونه زره ادارې وخت نیسي. (2) ساتنه — وسایل بدلیږي او د توکو بانکونه تازه کولو ته اړتیا لري. API لنډه لار ده: تاسو درې پای ټکي کاروئ، موږ سایکومیټریکس اوسني ساتو. دا د Scale په کچه ($199/mo) کې شتون لري، چې پکې د میاشتنۍ ارزونې تخصیص شامل دی. حد ارزونې شماري: هره وسیله چې تاسو یې ګمارئ یو واحد مصرفوي. سپین-لیبل ملګري چې زموږ ارزونې بیا پلوري کولی شي د عاید شریکولو ته لاړ شي.