Programmierbares Assessment-System
Betten Sie validierte Assessments in Ihr Produkt ein.
Drei REST-Aufrufe — start, questions, complete. X-API-Key Auth, serverseitiges Scoring, Ergebnisse Ihrer Organisation zugerechnet. RIASEC, Big Five, EQ, Skills Audit und 138+ Instrumente als API.
In Brief
JobCannons Assessment API stellt das Assessment-System und die Scoring-Ebene als Live-REST-Service auf dem Scale Tier bereit.
Die Integration besteht aus drei Aufrufen: POST /api/v1/assessments startet eine Sitzung und gibt den Fragensatz zurück; GET /api/v1/assessments/{session_id}/questions serviert diese Fragen erneut; POST /api/v1/assessments/{session_id}/complete sendet 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_…, Scopes assessments:send und assessments:read), SHA-256 gehashed im Ruhezustand — kein OAuth-Austausch. Sitzungen sind kurzlebige signierte Token, daher gibt es keinen Session Store auf der Partner-Seite.
Ergebnisse werden über api_org_id bei der Organisation des Partners gespeichert. Scoring verwendet denselben Code-Pfad wie das Consumer-Produkt, daher ist ein über die API bereitgestelltes Ergebnis identisch mit einem auf jobcannon.io erstellten, einschließlich der Integrität des Pool-Instruments. Rate Limiting erfolgt pro Schlüssel mit HTTP 429 + resetAt.
Verfügbar auf dem Scale Tier ($199/mo) mit monatlicher Assessment-Zuteilung und dann $2/Assessment Überschreitung; White-Label-Partner können zu Revenue-Share wechseln. Typische Anwender: HR-Tech- und ATS-Anbieter, LMS- und EdTech-Plattformen, Tools für Hochschul-Karrieredienste, Coaching-SaaS und NGO/Workforce-Fallmanagement-Systeme.
Was die API bietet
Ein Live-Zyklus mit drei Aufrufen — nicht ein schreibgeschützter Katalog.
Über API zugängliche Assessments
Starten Sie eine Sitzung mit einem beliebigen Instrument-Slug — Whitelist, was Ihre Integration nutzt.
Im Vergleich zum Eigenaufbau
Für die Einbettung validierter Assessments in Ihr Produkt
Was Entwickler erhalten
Passend dazu auf JobCannon
Die Assessment API ist eines der institutionellen Features auf dem JobCannon for Business Hub; Teams, die die eingebettete Erfahrung mit ihrer Marke abstimmen möchten, kombinieren es mit White-Label-Design. Für instrument-spezifische Integrationen siehe RIASEC API, Big Five API, und EQ API Seiten, oder die breitere Psychometric API und Personality Test API Übersichten.
Bauen Sie für eine spezifische Plattform? Siehe die API für LMS & EdTech, ATS & Recruiting, Coaching-Plattformen, und Universität Karrieredienste. Evaluieren Sie Anbieter? Vergleichen Sie uns als eine Traitify Alternative, Pearson TalentLens Alternative, oder Hogan Assessments Alternative.
API-Preisgestaltung
Die Embed-API ist live auf dem Scale Tier ($199/mo), das eine monatliche Assessment-Zuteilung umfasst; zusätzliche Assessments kosten $2 je. White-Label-Partner, die unsere Assessments weiterverkaufen, können zu einer Revenue-Share wechseln. Höhere Volumen, benutzerdefinierte Datenresidenz und spezialisierte technische Onboarding sind unter Partnership begrenzt.
Free
For micro-teams trying the platform
- ▸5 tests/month (resets the 1st of each month)
- ▸All 138+ assessments
- ▸Basic individual reports
- ▸Share link via email or Slack
- ▸Free trial of the coordinator dashboard
Starter
For solo coaches and small HR
- ▸30 assessments/mo included, then $2 each
- ▸All 138+ assessments
- ▸Detailed individual reports
- ▸Coach notes per candidate
- ▸PDF export (client-ready)
- ▸Session prep recommendations
- ▸Candidate progress tracking
Team
For startups, teams and HR
- ▸80 assessments/mo included, then $2 each
- ▸Everything in Starter
- ▸Team DNA dashboard
- ▸Compatibility matrix
- ▸Conflict-pattern detection
- ▸Compare 2-3 team members
- ▸Manager prep briefings
- ▸Shared admin access (2 seats)
Scale
For agencies, L&D and scale-ups
- ▸200 assessments/mo included, then $2 each
- ▸Everything in Team
- ▸Premium report (archetype + blind spots + work-style brief)
- ▸Integrity + social-desirability scales (fake-good detection)
- ▸White-label PDFs (your logo)
- ▸Full assessment API (start, score, retrieve results)
- ▸Bulk CSV import / export
- ▸Custom assessment builder (beta)
- ▸Unlimited admin seats
- ▸Priority email support
Growth
For high-volume screening without a contract
- ▸1,000 assessments/mo included, then $2 each
- ▸Everything in Scale
- ▸SSO (SAML, Google Workspace)
- ▸Invoice / PO billing, not just card
- ▸Named support contact with a response-time target
- ▸Annual billing option
Enterprise
For 200+ person companies
- ▸Unlimited tests
- ▸Everything in Scale
- ▸SSO (SAML, Google Workspace)
- ▸SLA (99.9% uptime)
- ▸Data residency options (EU/US)
- ▸Dedicated Customer Success
- ▸Custom integrations (Workday, Greenhouse, Slack)
- ▸Annual billing, invoice payments
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.
API-Zugang anfragen
Erzählen Sie uns von Ihrem Integration-Anwendungsfall und Ihrem erwarteten Volumen. Wir antworten mit einem Schlüssel, der Endpoint-Referenz und einem technischen Onboarding-Plan.
Sie stellt das JobCannon Assessment-System als programmierbaren Service bereit, den Ihr Produkt aufrufen kann. Ihre Benutzer nehmen ein validiertes Assessment — RIASEC, Big Five, EQ, Skills Audit oder eines der 138+ Instrumente — in Ihrer eigenen App vor und Sie erhalten ein bewertetes Ergebnis zurück. Der gesamte Zyklus besteht aus drei REST-Aufrufen: POST /api/v1/assessments startet eine Sitzung und gibt den Fragensatz zurück; GET /api/v1/assessments/{session_id}/questions ruft diese Fragen erneut auf, falls Sie sie benötigen; POST /api/v1/assessments/{session_id}/complete sendet die Antworten, bewertet sie serverseitig und gibt das Ergebnis zurück. Der gleiche Scoring-Code-Pfad, den das Consumer-Produkt verwendet (lib/scoring/compute.ts), läuft hinter der API, daher ist ein API-Ergebnis identisch mit einem auf jobcannon.io erstellten.
Jede Anfrage trägt einen X-API-Key Header. Ihr Schlüssel sieht wie jck_live_… aus und wird pro Organisation mit Scopes ausgegeben — assessments:send ermöglicht es Ihnen, Sitzungen zu starten und zu beenden, assessments:read ermöglicht es Ihnen, Fragen erneut abzurufen. Schlüssel werden SHA-256 gehashed im Ruhezustand und niemals im Klartext gespeichert. Es gibt keinen OAuth-Tanz und keinen Client-Secret-Austausch: ein Header, Scopes, widerrufbar. Eine Sitzung ist ein kurzlebiger signierter Token, der vom Start-Aufruf zurückgegeben wird, daher gibt es keine Sitzungstabelle, die Sie verwalten müssen 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 — serviert die Frage-Payload für eine laufende Sitzung erneut (Scope assessments:read). POST /api/v1/assessments/{session_id}/complete — Body { answers: number[], external_user_id? } wobei Answers Optionsindizes in der Reihenfolge sind, in der die Fragen gestellt wurden; gibt { result_id, test, top_result, scores, question_pool } zurück. Antworten werden auf Länge und degenerierte/unberührte Vektoren vor dem Scoring überprüft. Pool-Instrumente (z.B. die IQ-Batterie) führen den serviert Fragen-Pool durch zum richtigen Scoring-Schlüssel.
Jedes abgeschlossene Assessment wird Ihrer Organisation beigerechnet — die Ergebnis-Zeile wird mit Ihrer api_org_id geschrieben, daher wird es Ihnen zugerechnet, nicht zu einer anonymen Browser-Sitzung oder einem JobCannon Consumer-Konto. Der Complete-Aufruf gibt die result_id, das top_result (die Haupt-Archetype/Type/Code für dieses Instrument) und die vollständigen Per-Dimension-Scores zurück. Sie speichern die result_id und rendern das Ergebnis in Ihrem Produkt wie gewünscht. Die aktuelle v1 gibt das bewertete Ergebnis zurück; die reichere KI-Karriere-Guide-Narration (Kursempfehlungen, 2.521-Karriere-Zuordnung) ist eine separate Consumer-Oberfläche und ist pro Partner begrenzt, nicht eine Standard-v1-Antwort.
Anfragen werden pro API-Schlüssel Rate-limited (die Schlüssel-Identität, nicht die Anrufer-IP), daher startet eine laute Integration eine andere nicht aus. Über die Obergrenze erhalten Sie ein HTTP 429 mit einem resetAt Zeitstempel im Body — kein stilles Drosseln, keine verworfenen Anfragen. Jeder Start- und Complete-Aufruf wird gemessen, daher ist Ihr monatlicher Assessment-Zähler für die Abrechnung korrekt.
Teams, die Karriere-Assessments intern aufbauen, unterschätzen normalerweise zwei Kosten. (1) Validierte Item-Banken und Scoring — die RIASEC, Big Five und EQ Frameworks sind öffentlich, aber validierte Item-Pools und direktionale Scoring-Algorithmen nicht; das Aufbauen 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 live auf dem Scale Tier ($199/mo), das eine monatliche Assessment-Zuteilung umfasst, dann $2 pro Assessment über die Obergrenze. White-Label-Partner, die unsere Assessments weiterverkaufen, können zu einer Revenue-Share wechseln.