Moteur d'évaluation programmable
Intégrez des tests validés dans votre produit.
Trois appels REST — démarrer, questions, terminer. Authentification X-API-Key, scoring côté serveur, résultats attribués à votre organisation. RIASEC, Big Five, EQ, Skills Audit et 138+ instruments via API.
In Brief
L'API d'évaluation JobCannon expose le moteur d'évaluation et la couche de scoring comme un service REST actif sur le plan Scale.
L'intégration se fait en trois appels : POST /api/v1/assessments démarre une session et retourne l'ensemble des questions ; GET /api/v1/assessments/{session_id}/questions remet les questions à disposition ; POST /api/v1/assessments/{session_id}/complete soumet les réponses, les score côté serveur et retourne { result_id, top_result, scores }.
L'authentification se fait par un seul header X-API-Key (format de clé jck_live_…, scopes assessments:send et assessments:read), hashé SHA-256 au repos — pas d'échange OAuth. Les sessions sont des tokens signés de courte durée, donc pas besoin de magasin de sessions côté partenaire.
Les résultats sont conservés pour l'organisation du partenaire via api_org_id. Le scoring réutilise le même chemin de code que le produit grand public, donc un résultat livré par API est identique à celui pris sur jobcannon.io, y compris l'intégrité de la clé d'instrument en pool. La limitation de débit est par clé avec HTTP 429 + resetAt.
Disponible sur le plan Scale ($199/mo) avec un forfait mensuel de tests puis $2/test en dépassement ; les partenaires en white-label peuvent passer à un modèle de partage de revenus. Les utilisateurs typiques : fournisseurs de HR-tech et ATS, plateformes LMS et EdTech, outils de services d'orientation universitaires, SaaS de coaching et systèmes de gestion de cas NGO/workforce.
Ce que l'API vous offre
Un cycle de vie en trois appels actifs — pas un simple catalogue en lecture seule.
Tests accessibles via l'API
Démarrez une session avec n'importe quel slug d'instrument — mettez en liste blanche ceux que votre intégration utilise.
Comparé au développement interne
Pour intégrer une évaluation validée dans votre produit
Ce que les développeurs obtiennent
À lire aussi sur JobCannon
L'API d'évaluation est l'une des fonctionnalités institutionnelles du hub JobCannon pour les entreprises ; les équipes qui ont besoin que l'expérience embarquée corresponde à leur marque l'associent avec la personnalisation white-label. Pour les intégrations spécifiques à un instrument, consultez l'API RIASEC, l'API Big Five et l'API EQ pages, ou les aperçus plus larges de l'API psychométrique et l'API de test de personnalité.
Vous construisez pour une plateforme spécifique ? Consultez l'API pour LMS et EdTech, ATS et recrutement, plateformes de coaching et services d'orientation universitaires. Vous évaluez des fournisseurs ? Comparez-nous comme une alternative à Traitify, une alternative à Pearson TalentLens ou une alternative à Hogan Assessments.
Tarification de l'API
L'API d'intégration est active sur le plan Scale ($199/mo), qui inclut un forfait mensuel de tests ; les tests supplémentaires sont $2 chacun. Les partenaires en white-label qui revendent nos tests peuvent passer à un partage de revenus. Les volumes supérieurs, la résidence des données personnalisée et un onboarding technique dédié sont limités en partenariat.
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.
Demander l'accès à l'API
Décrivez-nous votre cas d'usage d'intégration et votre volume prévu. Nous répondons avec une clé, la référence endpoint et un plan d'onboarding technique.
Elle expose le moteur d'évaluation JobCannon comme un service programmable que votre produit peut appeler. Vos utilisateurs font un test validé — RIASEC, Big Five, EQ, Skills Audit ou n'importe lequel des 138+ instruments — dans votre propre application, et vous récupérez un résultat scoré. La boucle complète se fait en trois appels REST : POST /api/v1/assessments démarre une session et retourne l'ensemble des questions ; GET /api/v1/assessments/{session_id}/questions remet ces questions à disposition si vous en avez besoin à nouveau ; POST /api/v1/assessments/{session_id}/complete soumet les réponses, les score côté serveur et retourne le résultat. Le même chemin de code de scoring que le produit grand public (lib/scoring/compute.ts) s'exécute derrière l'API, donc un résultat API est identique à celui pris sur jobcannon.io.
Chaque requête porte un header X-API-Key. Votre clé ressemble à jck_live_… et est émise par organisation avec des scopes — assessments:send vous permet de démarrer et terminer des sessions, assessments:read vous permet de remettre les questions à disposition. Les clés sont hashées SHA-256 au repos et jamais stockées en plaintext. Il n'y a pas de danse OAuth et pas d'échange de secret client : un header, limité, révocable. Une session est un token signé de courte durée retourné par l'appel de démarrage, donc pas de table de sessions à gérer de votre côté et pas de polling.
POST /api/v1/assessments — corps { test, locale?, external_user_id?, pool? } ; retourne { session_id, test, locale, question_pool, total_questions, questions[] }. GET /api/v1/assessments/{session_id}/questions — remet la charge des questions à disposition pour une session en cours (scope assessments:read). POST /api/v1/assessments/{session_id}/complete — corps { answers: number[], external_user_id? } où les réponses sont les indices d'options dans l'ordre où les questions ont été servies ; retourne { result_id, test, top_result, scores, question_pool }. Les réponses sont validées pour la longueur et pour les vecteurs dégénérés/non touchés avant le scoring. Les instruments en pool (p.ex. la batterie de tests QI) font transiter le pool de questions servi vers la bonne clé de scoring.
Chaque test complété est conservé pour votre organisation — la ligne de résultat est écrite avec votre api_org_id, donc elle vous est attribuée, pas à une session navigateur anonyme ou un compte consommateur JobCannon. L'appel de completion retourne le result_id, le top_result (l'archétype de titre/type/code pour cet instrument) et les scores complets par dimension. Vous stockez le result_id et affichez le résultat dans votre produit comme vous le voulez. La v1 actuelle retourne le résultat scoré ; la narration plus riche AI Career Guide (recommandations de cours, mappage de 2 521 carrières) est une surface consommatrice distincte et est limitée par partenaire, pas une réponse v1 par défaut.
Les requêtes sont limitées par clé API (l'identité de la clé, pas l'IP de l'appelant), donc une intégration bavarde ne prive jamais une autre. Au-delà de la limite, vous recevez un HTTP 429 avec un timestamp resetAt dans le corps — pas de throttling silencieux, pas de requêtes perdues. Chaque appel start et complete est mesuré donc votre compte mensuel de tests est exact pour la facturation.
Les équipes qui construisent l'évaluation de carrière en interne sous-estiment généralement deux coûts. (1) Banques d'items validés et scoring — les frameworks RIASEC, Big Five et EQ sont publics, mais les pools d'items validés et les algorithmes de scoring directionnels ne le sont pas ; construire et valider les vôtres prend des années et des dizaines de milliers d'administrations. (2) Maintenance — les instruments dérivent et les banques d'items ont besoin de rafraîchissement. L'API est le raccourci : vous appelez trois endpoints, nous maintenons la psychométrie à jour. Elle est active sur le plan Scale ($199/mo), qui inclut un forfait mensuel de tests, puis $2 par test au-delà du forfait. Les partenaires en white-label qui revendent nos tests peuvent passer à un partage de revenus à la place.