Programmerbar testmotor
Tre REST-anrop — start, questions, complete. X-API-Key-autentisering, server-side scoring, resultat attributerade till din organisation. RIASEC, Big Five, EQ, Skills Audit och 133+ instrument som API.
JobCanons Assessment API exponerar testmotorn och scoring-lagret som en live REST-tjänst på Scale-nivån.
Integreringen består av tre anrop: POST /api/v1/assessments startar en session och returnerar frågorna; GET /api/v1/assessments/{session_id}/questions serverar dessa frågor igen; POST /api/v1/assessments/{session_id}/complete skickar svar, bedömer dem server-side och returnerar { result_id, top_result, scores }.
Autentisering är en enskild X-API-Key-rubrik (nyckelformat jck_live_…, scopes assessments:send och assessments:read), SHA-256-hasherad i lagring — ingen OAuth-utväxling. Sessioner är kortlivade signerade tokens, så det finns ingen sessionslager på partnerens sida.
Resultat lagras för partnerns organisation via api_org_id. Scoring återanvänder samma kodväg som konsumentprodukten, så ett API-levererat resultat är identiskt med ett från jobcannon.io, inklusive pooled-instrument nyckelintegritet. Hastighetsbegränsning är per nyckel med HTTP 429 + resetAt.
Tillgänglig på Scale-nivån ($199/mo) med en månatlig testöverenskommelse och sedan $2/test för överförbrukning; white-label-partners kan övergå till intäktsdelning. Typiska adoptörer: HR-tech och ATS-leverantörer, LMS och EdTech-plattformar, universitetets karriärtjänstverktyg, coaching SaaS och NGO/arbetsgivarstyrningsystem.
En live trecalls livscykel — inte en skrivskyddad katalog.
Starta en session med vilket instrumentslug som helst — vitlista vad din integration använder.
För att bädda in validerad bedömning i din produkt
Assessment API:et är en av de institutionella funktionerna på JobCannon for Business-hubben; team som behöver den inbäddade upplevelsen för att matcha deras varumärke parar det med white-label-tema. För instrumentspecifika integrationer, se RIASEC API, Big Five API, och EQ API sidor, eller den bredare psykometrisk API och personlighetstests API översikter.
Bygga för en specifik plattform? Se API:et för LMS & EdTech, ATS & rekrytering, coachingplattformar, och universitetets karriärtjänster. Utvärderar leverantörer? Jämför oss som ett Traitify-alternativ, Pearson TalentLens alternativ, eller Hogan Assessments-alternativ.
Bädda-in-API:et är live på Scale-nivån ($199/mo), som inkluderar en månatlig testöverenskommelse; ytterligare tester är $2 var. White-label-partners som sälja våra tester kan övergå till en intäktsdelning. Högre volymer, anpassad datainbyggnad och dedikerad teknisk onboarding omfattas under partnerskap.
For micro-teams trying the platform
For solo coaches and small HR
For startups, teams and HR
For agencies, L&D and scale-ups
For high-volume screening without a contract
For 200+ person companies
Self-serve checkout via Stripe — major cards, Apple Pay, Google Pay, Link. Cancel anytime; 14-day money-back on every paid plan. Enterprise via the contact form below.
Berätta för oss ditt integrationsanvändningsfall och din förväntade volym. Vi svarar med en nyckel, slutpunktsreferensen och en teknisk onboarding-plan.
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 133+ 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 testöverenskommelse, sedan $2 per test över gränsen. White-label-partners som sälja våra tester kan övergå till en intäktsdelning istället.