Programmierbares Assessment-System
Drei REST-Aufrufe — Start, Fragen, Abschluss. X-API-Key-Authentifizierung, serverseitige Bewertung, Ergebnisse Ihrer Organisation zugeordnet. RIASEC, Big Five, EQ, Skills Audit und 127+ Instrumente als API.
Die Assessment API von JobCannon macht das Assessment-System und die Bewertungslogik als Live-REST-Service im Scale-Tarif verfügbar.
Die Integration umfasst drei Aufrufe: POST /api/v1/assessments startet eine Sitzung und gibt die Fragenliste zurück; GET /api/v1/assessments/{session_id}/questions stellt diese Fragen erneut bereit; POST /api/v1/assessments/{session_id}/complete übermittelt Antworten, bewertet sie serverseitig und gibt { result_id, top_result, scores } zurück.
Die Authentifizierung erfolgt über einen einzelnen X-API-Key-Header (Schlüsselformat jck_live_…, Bereiche assessments:send und assessments:read), SHA-256-gehashed im Ruhezustand — keine OAuth-Vermittlung. Sitzungen sind kurzlebige signierte Token, daher gibt es keinen Sitzungsspeicher auf Partnerseite.
Ergebnisse werden über api_org_id in der Organisation des Partners gespeichert. Die Bewertung nutzt denselben Codepfad wie das Verbraucherprodukt, daher ist ein über die API bereitgestelltes Ergebnis identisch mit einem auf jobcannon.io durchgeführten, einschließlich Schlüsselintegrität für gepoolte Instrumente. Die Ratenbegrenzung erfolgt pro Schlüssel mit HTTP 429 + resetAt.
Verfügbar im Scale-Tarif ($199/mo) mit monatlicher Assessment-Zuteilung und dann $2/Assessment Überschussgebühr; White-Label-Partner können zu Umsatzbeteiligung übergehen. Typische Anwender: HR-Tech und ATS-Anbieter, LMS und EdTech-Plattformen, Universitäts-Karriereservices, Coaching-SaaS und NGO/Workforce-Case-Management-Systeme.
Ein Live-Lebenszyklus aus drei Aufrufen — nicht nur ein Lesekatalog.
Starten Sie eine Sitzung mit einem beliebigen Instrument-Slug — definieren Sie eine Whitelist für die Instrumente, die Ihre Integration verwendet.
Für die Einbindung validierter Assessments in Ihr Produkt
Die Assessment API ist eines der institutionellen Features auf dem JobCannon for Business Hub; Teams, die möchten, dass das Embedded-Erlebnis ihrer Marke entspricht, kombinieren es mit White-Label-Theming. Für instrumentenspezifische Integrationen siehe die RIASEC API, Big Five API und EQ API Seiten oder die breiteren Psychometric API und Personality Test API Übersichten.
Entwickeln für eine bestimmte Plattform? Siehe die API für LMS & EdTech, ATS & Recruiting, Coaching-Plattformen und Universitäts-Karriereservices. Evaluieren Sie Anbieter? Vergleichen Sie uns als Traitify-Alternative, Pearson TalentLens-Alternative oder Hogan Assessments-Alternative.
Die Embed-API ist im Scale-Tarif live ($199/mo), der eine monatliche Assessment-Zuteilung umfasst; zusätzliche Assessments kosten $2 pro Stück. White-Label-Partner, die unsere Assessments weiterverkaufen, können zu einer Umsatzbeteiligung wechseln. Höhere Volumen, benutzerdefinierte Datenresidenz und dediziertes technisches Onboarding werden unter Partnerschaft definiert.
Always free for micro-teams
For solo coaches and small HR
For startups, teams and HR
For agencies, L&D and scale-ups
For 200+ person companies
Self-serve checkout via Stripe — major cards, Apple Pay, Google Pay, Link. Cancel anytime; 14-day money-back on Starter, Team, and Scale. Enterprise via the contact form below.
Teilen Sie uns Ihren Integrations-Anwendungsfall und Ihr erwartetes Volumen mit. Wir antworten mit einem Schlüssel, der Endpoint-Referenz und einem technischen Onboarding-Plan.
Sie macht das JobCannon Assessment-System als programmierbaren Service verfügbar, den Ihr Produkt aufrufen kann. Ihre Benutzer führen ein validiertes Assessment durch — RIASEC, Big Five, EQ, Skills Audit oder eines der 127+ Instrumente — in Ihrer eigenen App durch, und Sie erhalten ein bewertetes Ergebnis zurück. Die gesamte Schleife umfasst drei REST-Aufrufe: POST /api/v1/assessments startet eine Sitzung und gibt die Fragenliste zurück; GET /api/v1/assessments/{session_id}/questions holt diese Fragen bei Bedarf erneut ab; POST /api/v1/assessments/{session_id}/complete übermittelt die Antworten, bewertet sie serverseitig und gibt das Ergebnis zurück. Derselbe Bewertungs-Codepfad, den das Verbraucherprodukt nutzt (lib/scoring/compute.ts), läuft hinter der API, daher ist ein API-Ergebnis identisch mit einem auf jobcannon.io durchgeführten.
Jede Anfrage enthält einen X-API-Key-Header. Ihr Schlüssel sieht wie jck_live_… aus und wird pro Organisation mit Bereichen ausgegeben — assessments:send ermöglicht das Starten und Abschließen von Sitzungen, assessments:read ermöglicht das erneute Abrufen von Fragen. Schlüssel werden SHA-256-gehashed im Ruhezustand und niemals im Klartext gespeichert. Es gibt keinen OAuth-Handshake und keinen Client-Geheimnis-Austausch: ein Header, beschränkt, widerrufbar. Eine Sitzung ist ein kurzlebiger signierter Token, der vom Start-Aufruf zurückgegeben wird, daher gibt es keine Sitzungstabelle auf Ihrer Seite und kein Polling.
POST /api/v1/assessments — Body { test, locale?, external_user_id?, pool? }; gibt { session_id, test, locale, question_pool, total_questions, questions[] } zurück. GET /api/v1/assessments/{session_id}/questions — stellt die Frage-Payload für eine laufende Sitzung erneut bereit (Bereich assessments:read). POST /api/v1/assessments/{session_id}/complete — Body { answers: number[], external_user_id? } wobei Antworten Optionsindizes in der Reihenfolge sind, in der die Fragen bereitgestellt wurden; gibt { result_id, test, top_result, scores, question_pool } zurück. Antworten werden auf Länge und entartete/unberührte Vektoren vor der Bewertung validiert. Gepoolte Instrumente (z. B. die IQ-Batterie) leiten den bereitgestellten Fragensatz an den richtigen Bewertungsschlüssel durch.
Jedes abgeschlossene Assessment wird in Ihrer Organisation gespeichert — die Ergebniszeile wird mit Ihrer api_org_id geschrieben, daher wird sie Ihnen zugeordnet, nicht einer anonymen Browser-Sitzung oder einem JobCannon-Verbraucherkonto. Der Complete-Aufruf gibt result_id, top_result (den Schlagwort-Archetyp/Typ/Code für dieses Instrument) und die vollständigen Dimensionswerte zurück. Sie speichern die result_id und stellen das Ergebnis in Ihrem Produkt wie gewünscht dar. Die aktuelle v1 gibt das bewertete Ergebnis zurück; die reichhaltigere KI-Karriereguide-Erzählung (Kursempfehlungen, 2.536-Karriere-Mapping) ist eine separate Verbraucherfläche und ist pro Partner begrenzt, nicht eine Standard-v1-Antwort.
Anfragen werden pro API-Schlüssel ratenbegrenzt (die Schlüsselidentität, nicht die IP des Aufrufers), daher startet eine rauschende Integration nie eine andere. Über der Grenze erhalten Sie HTTP 429 mit einem resetAt-Zeitstempel im Body — kein stilles Drosseln, keine verworfenen Anfragen. Jeder Start- und Complete-Aufruf wird gemessen, daher ist Ihre monatliche Assessment-Anzahl für die Abrechnung genau.
Teams, die Karriere-Assessments hausinternal entwickeln, unterschätzen normalerweise zwei Kosten. (1) Validierte Item-Banken und Bewertung — die RIASEC-, Big-Five- und EQ-Frameworks sind öffentlich, aber validierte Item-Pools und direktionale Bewertungsalgorithmen nicht; das Erstellen und Validieren Ihrer eigenen dauert Jahre und zehntausende Durchführungen. (2) Wartung — Instrumente driften und Item-Banken benötigen Aktualisierung. Die API ist die Abkürzung: Sie rufen drei Endpoints auf, wir halten die Psychometrie aktuell. Sie ist im Scale-Tarif live ($199/mo), der eine monatliche Assessment-Zuteilung umfasst, dann $2 pro Assessment über der Grenze. White-Label-Partner, die unsere Assessments weiterverkaufen, können zu einer Umsatzbeteiligung wechseln.