I-embed ang validated assessments sa iyong product.

Nag-expose ito ng JobCannon assessment engine bilang programmable service na maaaring tawarang gamitin ng iyong product. Ang iyong mga user ay kumukuha ng validated assessment — RIASEC, Big Five, EQ, Skills Audit, o anumang 201+ instruments — sa loob ng iyong sariling app, at nakakakuha ka ng scored result. Ang buong loop ay tatlong REST calls: POST /api/v1/assessments ay nagsisimula ng session at nagbabalik ng question set; GET /api/v1/assessments/{session_id}/questions ay nag-fetch ulit ng mga tanong kung kailangan mo; POST /api/v1/assessments/{session_id}/complete ay nag-submit ng answers, nag-score sa server-side, at nagbabalik ng result. Ang parehong scoring code path ang consumer product ay gumagamit (lib/scoring/compute.ts) ay tumatakbo sa likod ng API, kaya ang API result ay identical sa isa na na-take sa jobcannon.io.

Bawat request ay nag-carry ng X-API-Key header. Ang iyong key ay parang jck_live_… at inilabas per organisation na may scopes — assessments:send ay nagpapahintulot sa iyo na magsimula at kumpletuhin ang sessions, assessments:read ay nagpapahintulot sa iyo na mag-re-fetch ng mga tanong. Ang mga keys ay SHA-256 hashed sa rest at hindi kailanman nakalagay sa plaintext. Walang OAuth dance at walang client-secret exchange: isang header, scoped, revocable. Ang session ay isang short-lived signed token na ibinalik ng start call, kaya walang session table na pangasiwaan sa iyong side at walang polling.

POST /api/v1/assessments — body { test, locale?, external_user_id?, pool? }; nagbabalik ng { session_id, test, locale, question_pool, total_questions, questions[] }. GET /api/v1/assessments/{session_id}/questions — nag-re-serve ng question payload para sa in-progress session (scope assessments:read). POST /api/v1/assessments/{session_id}/complete — body { answers: number[], external_user_id? } kung saan ang mga answers ay option indices sa order na inilabas ang mga tanong; nagbabalik ng { result_id, test, top_result, scores, question_pool }. Ang mga answers ay validated para sa length at para sa degenerate/untouched vectors bago ang scoring. Ang pooled instruments (e.g. ang IQ battery) ay nag-thread ng served question pool sa tamang scoring key.

Bawat completed assessment ay nag-persist sa iyong organisation — ang result row ay sinusulat na may iyong api_org_id, kaya ito ay attributed sa iyo, hindi sa anonymous browser session o JobCannon consumer account. Ang complete call ay nagbabalik ng result_id, ang top_result (ang headline archetype/type/code para sa instrument na iyon), at ang full per-dimension scores. Ang result_id mo ay nistoring at nire-render ang outcome sa loob ng iyong product kung paano mo gustong gawin. Ang current v1 ay nagbabalik ng scored result; ang mas rich na AI Career Guide narrative (course recommendations, 2,521-career mapping) ay isang separate consumer surface at scoped per partner, hindi default v1 response.

Ang mga requests ay rate-limited per API key (ang key identity, hindi ang caller IP), kaya isang noisy integration ay hindi kailanman nag-starve ng iba. Sa lampas ng limit ka ay nakakakuha ng HTTP 429 na may resetAt timestamp sa body — walang silent throttling, walang dropped requests. Bawat start at complete call ay metered kaya ang iyong monthly assessment count ay accurate para sa billing.

Ang mga teams na bumubuo ng career-assessment in-house ay karaniwang nag-underestimate ng dalawang costs. (1) Validated item banks at scoring — ang pag-build at pag-validate ng iyong sarili ay tumatagal ng mga taon at libu-libong administrations. (2) Maintenance — ang instruments ay bumabago at ang item banks ay kailangan mag-refresh. Ang API ay ang shortcut: ikaw ay nagtawag ng tatlong endpoints, kami ay nagpapanatili ng psychometrics na current. Ito ay live sa Scale tier ($199/mo), na kasama ang monthly assessment allotment. Ang cap ay binabibilang assessments: bawat instrument na iyong ina-assign ay gumagastos ng isang unit. Ang white-label partners na muling nagbebenta ng aming assessments ay maaaring lumipat sa revenue-share sa halip.