Bädda in validerade tester i din produkt.

Det exponerar JobCanons testmotor som en programmerbar tjänst din produkt kan anropa. Dina användare tar ett validerat test — RIASEC, Big Five, EQ, Skills Audit eller någon av 186+ instrumenten — inuti din egen app, och du får ett bedömt resultat tillbaka. Hela loopen är tre REST-anrop: POST /api/v1/assessments startar en session och returnerar frågorna; GET /api/v1/assessments/{session_id}/questions hämtar dessa frågor igen om du behöver dem; POST /api/v1/assessments/{session_id}/complete skickar svaren, bedömer dem server-side och returnerar resultatet. Samma scoring-kodväg som konsumentprodukten använder (lib/scoring/compute.ts) körs bakom API:et, så ett API-resultat är identiskt med ett från jobcannon.io.

Varje begäran bär en X-API-Key-rubrik. Din nyckel ser ut som jck_live_… och är utfärdad per organisation med scopes — assessments:send låter dig starta och slutföra sessioner, assessments:read låter dig hämta frågor igen. Nycklar är SHA-256-hasherade i lagring och lagras aldrig i klartext. Det finns ingen OAuth-dans och ingen klienthemlighetsutväxling: en rubrik, begränsad, återkallningsbar. En session är en kortlivad signerad token som returneras av startsampet, så det finns ingen sessionstabell att hantera på din sida och ingen polling.

POST /api/v1/assessments — body { test, locale?, external_user_id?, pool? }; returnerar { session_id, test, locale, question_pool, total_questions, questions[] }. GET /api/v1/assessments/{session_id}/questions — serverar frågepaketet igen för en pågående session (scope assessments:read). POST /api/v1/assessments/{session_id}/complete — body { answers: number[], external_user_id? } där svar är alternativindex i den ordning frågorna serverades; returnerar { result_id, test, top_result, scores, question_pool }. Svar valideras för längd och för degenererade/orörda vektorer innan scoring. Poolade instrument (t.ex. IQ-batteriet) trådda det serverade frågepaketet genom till rätt scoring-nyckel.

Varje slutförd test lagras för din organisation — resultatraden skrivs med din api_org_id, så det är attributerat till dig, inte till en anonym webbläsarsession eller ett JobCannon-konsumentkonto. Complete-anropet returnerar result_id, top_result (huvudarkitypen/typen/koden för det instrumentet) och de fullständiga per-dimension-poängen. Du lagrar result_id och renderar resultatet inuti din produkt hur du än vill. Den nuvarande v1 returnerar det bedömda resultatet; den rikare AI Career Guide-narrativet (kursrekommendationer, 2 521-karriärkarta) är en separat konsumentytan och är begränsad per partner, inte en standard v1-svar.

Begäranden är hastighetsbegränsade per API-nyckel (nyckelidentiteten, inte anroparens IP), så en bullrig integration stjäl aldrig en annan. över gränsen får du en HTTP 429 med en resetAt-tidsstämpel i kroppen — ingen tyst begränsning, inga bortkastade begäranden. Varje start- och complete-anrop mäts så att din månatliga testräkning är korrekt för faktureringen.

Team som bygger karriärbedömning internt underestimerar vanligtvis två kostnader. (1) Validerade föremålsbanker och scoring — ramverken RIASEC, Big Five och EQ är offentliga, men validerade föremålspooler och riktningsalgoritmer är det inte; att bygga och validera dina egna tar år och tiotusentals administrationer. (2) Underhåll — instrument driver och föremålsbanker behöver uppdateras. API:et är genvägen: du anropar tre slutpunkter, vi håller psykometrin aktuell. Det är live på Scale-nivån ($199/mo), som inkluderar en månatlig bedömningskvot. Gränsen räknar bedömningar: varje instrument du tilldelar förbrukar en enhet. White-label-partners som sälja våra tester kan övergå till en intäktsdelning istället.