Qormaatawwan mirkanaa'oo oomisha keessan keessatti galchaa.

Injinniin madaallii JobCannon akka tajaajila piroogiraamii ta'ee oomisha keessan waamuu danda'uuf banaa taasisa. Fayyadamtoonni keessan madaallii mirkanaa'e — RIASEC, Big Five, EQ, Skills Audit, yookiin meeshaalee 201+ kamiyyuu — appilikeeshinii keessan keessatti fudhatu, isinis bu'aa qabxii itti galmeeffame argattu. Guutummaan adeemsa kanaa waamicha REST sadii qaba: POST /api/v1/assessments sagantaa jalqabee gaaffiiwwan deebisa; GET /api/v1/assessments/{session_id}/questions yoo irra deebiin isin barbaachise gaaffiiwwan sana ni deebisa; POST /api/v1/assessments/{session_id}/complete deebiiwwan galchee, server-side irratti qabxii galmeessee, bu'aa deebisa. Koodiin qabxii galmeessuu kan oomisha fayyadamaaf oolu (lib/scoring/compute.ts) API duuba hojjeta, kanaafuu bu'aan API kan jobcannon.io irratti argamu wajjin tokkuma.

Waamichi hundi X-API-Key header qaba. Furtuun keessan jck_live_… fakkaata, dhaabbata tokkoof kan kennamu yoo ta'u, scopes qaba — assessments:send sagantaa jalqabuu fi xumuruu isin dandeessisa, assessments:read gaaffiiwwan irra deebiin akka argattan isin dandeessisa. Furtuuwwan yeroo hin hojjenne SHA-256 hashed ta'u, barreeffama ifaatiin hin kuufaman. OAuth dance fi waljijjiirraa client-secret hin jiru: header tokko, kan daangeffame, kan haqamuu danda'u. Sagantaan mallattoo yeroo gabaabaaf tajaajilu kan waamicha jalqabaatiin deebi'uudha, kanaafuu gabatee sagantaa gama keessaniin bulchuun hin jiru, akkasumas polling hin jiru.

POST /api/v1/assessments — body { test, locale?, external_user_id?, pool? }; returns { session_id, test, locale, question_pool, total_questions, questions[] }. GET /api/v1/assessments/{session_id}/questions — gaaffiiwwan sagantaa adeemsa irra jiruuf irra deebiin tajaajila (scope assessments:read). POST /api/v1/assessments/{session_id}/complete — body { answers: number[], external_user_id? } deebiiwwan tartiiba gaaffiiwwan ittiin dhiyaataniin option indices ta'anii; returns { result_id, test, top_result, scores, question_pool }. Deebiiwwan dheerinaa fi veektariiwwan hin tuqamneef qabxii galmeessuu dura ni mirkanaa'u. Meeshaaleen walitti qabaman (fkn. IQ battery) gaaffiiwwan dhiyaatan furtuu qabxii sirriitti geessu.

Madaalliin xumurame hundi dhaabbata keessanitti kuufama — sarari bu'aa api_org_id keessaniin barreeffama, kanaafuu isiniif galmaa'a, sagantaa biraawzarii beekamaa hin taaneef yookiin akkaawuntii fayyadamaa JobCannon-iif miti. Waamichi xumuraa result_id, top_result (archetype/type/code mata duree meeshaa sanaaf), fi qabxiiwwan guutuu dimenshinii hundaaf deebisa. Isin result_id kuufattanii bu'aa oomisha keessan keessatti akka barbaaddanitti agarsiiftu. V1-n ammaa bu'aa qabxii itti galmeeffame deebisa; seeneffamni AI Career Guide bal'aan (yaada koorsii, 2,521-career mapping) qaama fayyadamaa addaati, hiriyaa hundaaf kan daangeffame malee deebii v1 idilee miti.

Waamichi furtuu API tokkoon daangeffama (eenyummaa furtuu, IP waamichaa miti), kanaafuu wal-quunnamsiisuun tokko kan biraa hin danqu. Yoo daangaa darbitan HTTP 429 kan resetAt timestamp qaama isaa keessatti qabu argattu — ukkaamsuun callisaa, waamichi gatamuun hin jiru. Waamichi jalqabaa fi xumuraa hundi ni safarama, kanaafuu lakkoofsi madaallii ji'aa keessanii kaffaltii sirrii ta'a.

Gareen madaallii ogummaa mana keessatti ijaaran yeroo baay'ee baasii lama xiqqeessanii ilaalu. (1) Baankiiwwan gaaffii mirkanaa'anii fi qabxii galmeessuu — kan mataa keessanii ijaaruun fi mirkaneessuun waggootaa fi bulchiinsa kumaatamaan lakkaa'amu fudhata. (2) Supha — meeshaaleen ni jijjiiramu, baankiiwwan gaaffii haaromsa barbaadu. API-n karaa gabaabaadha: isin endpoint sadii waamtu, nuti saayikomeetiriiksii ammayyeessinee eegna. Sadarkaa Scale ($199/mo) irratti argama, kunis madaallii ji'aa kan of keessatti qabateedha. Daangaan madaallii lakkaa'a: meeshaan isin ramaddan hundi yuunitii tokko baasa. Hiriyaaleen white-label madaallii keenya gurguran gara qooda galii jijjiiruu danda'u.