Расталған тестілерді өнімінізге ендіріңіз.

Ол JobCannon бағалау платформасын сіздің өнім шақыра алатын бағдарланатын сервис ретінде ұсынады. Сіздің пайдаланушылары расталған бағалауды — RIASEC, Big Five, EQ, Skills Audit немесе 138+ құралдарының кез-келгені — өз қосымшасы ішінде орындайды және сіз ұпайланған нәтижені аласыз. Толық цикл үш 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 — body { 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 — body { answers: number[], external_user_id? } мұнда answers сұрақтар берілген ретіндегі опция индекстері; { result_id, test, top_result, scores, question_pool } қайтарады. Жауап ұзындығы және ыңғайсыз/нөлдік векторлар ұпайлау бұрын тексеріледі. Топтақы құралдар (мысалы IQ тестісі) беріліген сұрақ бассейнін дұрыс ұпайлау кілтіне саласы.

Әрбір аяқталған бағалау сіздің ұйымыңызға сақталады — нәтиже жолы api_org_id-ңіз бар жазылады, сондықтан ол сізге сызамды, құр браузер сеансына немесе JobCannon тұтынушы есептік жазбасына емес. Толық сұрау result_id, top_result (ол құрал үшін басты прототип/түрі/коды) және толық өлшем пен өлшем ұпайларын қайтарады. Сіз result_id сақтау және нәтижені өнім ішінде қалағаныңыздай көрсету. Ағымды v1 ұпайланған нәтижені қайтарады; құлпырық AI Карьер Гидесі айтылымы (курс ынамдану, 2 521-карьер картасы) бөлек тұтынушы бетін және әрбір серіктеспен ауқымдалған, v1 әдепкі жауабы емес.

Сұрау әрбір API кілт бойынша шектелінді (кілт сәйкестігі, емес шақыруы IP), сондықтан бір шумалы интеграция басқасын мал болмайды. Шекті асқанда сіз HTTP 429 және resetAt уақытты ішімалі аласыз — және т.б. сыйлап шектелу немесе түсіп қалған сұрау жоқ. Әрбір басталу және аяқтау сұрау өлшенді, сондықтан сіздің ай сайынғы тест есебі төлеу үшін дәл.

Мансап бағалауды өз күшімен құрастыратын топтар әдетте екі шығынды төмен бағалайды. (1) Тексерілген сұрақ базасы және бағалау — RIASEC, Big Five және EQ шеңберлері ашық, бірақ тексерілген сұрақ жинақтары мен бағыттық бағалау алгоритмдері ашық емес; өзіңіздің жүйеңізді құрастыру және тексеру бірнеше жыл және ондаған мың өткізуді қажет етеді. (2) Қолдау — құралдар өзгеріп отырады және сұрақ базасын жаңарту керек. API — қысқа жол: сіз үш нүктеге сұраныс жібересіз, біз психометриканы жаңа күйде ұстаймыз. Бұл Scale деңгейінде ($199/mo) қолжетімді, оған айлық бағалау саны кіреді, одан кейін шектен асқан әрбір бағалау үшін $2. Біздің бағалауларды қайта сататын ақ таңбалы серіктестер табыс бөлісуге көше алады.