Programmeerbare assessment-engine
Drie REST-aanroepen — start, vragen, voltooien. X-API-Key-authenticatie, server-side scoring, resultaten toegewezen aan uw organisatie. RIASEC, Big Five, EQ, Skills Audit en 133+ instrumenten als een API.
JobCannon's Assessment API stelt de assessment-engine en scoring-laag bloot als een live REST-service op de Scale-tier.
Integratie bestaat uit drie aanroepen: POST /api/v1/assessments start een sessie en retourneert de vragenset; GET /api/v1/assessments/{session_id}/questions serveert die vragen opnieuw; POST /api/v1/assessments/{session_id}/complete verzendt antwoorden, scoort ze server-side, en retourneert { result_id, top_result, scores }.
Authenticatie is een enkele X-API-Key-header (sleutelformaat jck_live_…, bereiken assessments:send en assessments:read), SHA-256-gehashed in rust — geen OAuth-uitwisseling. Sessies zijn korte-termijn ondertekende tokens, dus er is geen sessie-opslag aan de partnerkant.
Resultaten blijven behouden voor de organisatie van de partner via api_org_id. Scoring hergebruikt dezelfde codecontour als het consumentenproduct, dus een API-geleverd resultaat is identiek aan een resultaat uit jobcannon.io, inclusief integriteit van gepoolen-instrument-sleutel. Rate limiting per sleutel met HTTP 429 + resetAt.
Beschikbaar op de Scale-tier ($199/mo) met een maandelijkse assessment-toewijzing en vervolgens $2/assessment overschrijding; white-label-partners kunnen overgaan op revenue-share. Typische gebruikers: HR-tech en ATS-leveranciers, LMS- en EdTech-platforms, loopbaanadviestools voor universiteiten, coaching SaaS, en NGO/workforce-case-management-systemen.
Een live drie-aanroep-levenscyclus — niet een alleen-lezen catalogus.
Start een sessie met een willekeurig instrument-slug — whitelist wat uw integratie gebruikt.
Voor het inbedden van geverifieerde assessment in uw product
De Assessment API is één van de institutionele functies op de JobCannon for Business-hub; teams die willen dat de ingebedde ervaring overeenkomt met hun merk combineren het met white-label thema. Voor instrument-specifieke integraties, zie de RIASEC API, Big Five API, en EQ API pagina's, of de bredere psychometrische API en persoonlijkheid test API overzichten.
Bouwen voor een specifiek platform? Zie de API voor LMS & EdTech, ATS & recruitment, coachingplatformen, en universiteit loopbaanservices. Leveranciers evalueren? Vergelijk ons als een Traitify-alternatief, Pearson TalentLens-alternatief, of Hogan Assessments-alternatief.
De embed API is live op de Scale-tier ($199/mo), die een maandelijkse assessment-toewijzing bevat; aanvullende assessments zijn $2 per stuk. White-label-partners die onze assessments doorverkopen kunnen naar revenue-share overstappen. Hogere volumes, aangepaste gegevenslocatie en dedicated technische onboarding vallen onder partnerschapsbereik.
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.
Vertel ons uw integratiegebruiksscenario en uw verwachte volume. Wij reageren met een sleutel, de eindpuntreferentie, en een technisch onboarding-plan.
Het stelt de JobCannon assessment-engine bloot als een programmeerbare service die uw product kan aanroepen. Uw gebruikers nemen een geverifieerde assessment — RIASEC, Big Five, EQ, Skills Audit, of een van de 133+ instrumenten — in uw eigen app, en u krijgt een gescoord resultaat terug. De volledige lus bestaat uit drie REST-aanroepen: POST /api/v1/assessments start een sessie en retourneert de vragenset; GET /api/v1/assessments/{session_id}/questions haalt die vragen opnieuw op als nodig; POST /api/v1/assessments/{session_id}/complete verzendt de antwoorden, scoort ze server-side, en retourneert het resultaat. Dezelfde scoring-codecontour die het consumentenproduct gebruikt (lib/scoring/compute.ts) wordt achter de API uitgevoerd, dus een API-resultaat is identiek aan een resultaat uit jobcannon.io.
Elke aanvraag voert een X-API-Key-header mee. Uw sleutel ziet er uit als jck_live_… en wordt per organisatie uitgegeven met bereiken — assessments:send laat u sessies starten en voltooien, assessments:read laat u vragen opnieuw ophalen. Sleutels worden SHA-256-gehashed in rust en nooit in ongecodeerde vorm opgeslagen. Er is geen OAuth-dans en geen client-secret-uitwisseling: één header, gericht, intrekbaar. Een sessie is een korte-termijn ondertekende token die door de start-aanroep wordt geretourneerd, dus er is geen sessie-tabel om aan uw kant te beheren en geen polling.
POST /api/v1/assessments — body { test, locale?, external_user_id?, pool? }; retourneert { session_id, test, locale, question_pool, total_questions, questions[] }. GET /api/v1/assessments/{session_id}/questions — serveert de vraagbelasting opnieuw voor een sessie in uitvoering (bereik assessments:read). POST /api/v1/assessments/{session_id}/complete — body { answers: number[], external_user_id? } waarbij antwoorden optie-indices zijn in de volgorde waarin de vragen werden geserveerd; retourneert { result_id, test, top_result, scores, question_pool }. Antwoorden worden gevalideerd op lengte en op gedegenereerde/onberoerde vectoren vóór scoring. Gepoolen instrumenten (bijv. de IQ-batterij) voeren de geserveerde vragenpool door naar de juiste scoring-sleutel.
Elke voltooide assessment wordt behouden voor uw organisatie — de resultaatrij wordt geschreven met uw api_org_id, dus het wordt aan u toegewezen, niet aan een anonieme browsersessie of JobCannon-consumentenaccount. De complete-aanroep retourneert de result_id, de top_result (het koppelarchietype/type/code voor dat instrument), en de volledige scores per dimensie. U slaat de result_id op en rendert de uitkomst in uw product echter u wilt. De huidige v1 retourneert het gescoorde resultaat; de rijkere AI Career Guide-narratief (cursusaanbevelingen, 2.521-career mapping) is een apart consumentenoppervlak en is per partner gericht, niet een standaard v1-response.
Aanvragen hebben rate limiting per API-sleutel (de sleutel-identiteit, niet de aanroeper-IP), dus één lawaaierige integratie verhongert nooit een andere. Boven de limiet krijgt u een HTTP 429 met een resetAt-timestamp in de body — geen stille throttling, geen verloren aanvragen. Elke start- en complete-aanroep wordt gemeten, dus uw maandelijkse assessment-teller is nauwkeurig voor facturering.
Teams die loopbaanassessment in-house bouwen, onderschatten meestal twee kosten. (1) Geverifieerde itembankken en scoring — de RIASEC-, Big Five- en EQ-kaders zijn openbaar, maar geverifieerde itembankken en directionele scoring-algoritmen niet; het bouwen en valideren van uw eigen neemt jaren en tienduizenden uitvoeringen. (2) Onderhoud — instrumenten verouderen en itembankken hebben verversing nodig. De API is de snelkoppeling: u roept drie eindpunten aan, wij houden de psychometrie actueel. Het is live op de Scale-tier ($199/mo), die een maandelijkse assessment-toewijzing bevat, vervolgens $2 per assessment boven de limiet. White-label-partners die onze assessments doorverkopen kunnen naar revenue-share overstappen.