Moteur d'évaluation programmable
Trois appels REST — démarrage, questions, fin. Authentification X-API-Key, scoring côté serveur, résultats attribués à votre organisation. RIASEC, Big Five, EQ, Skills Audit et 127+ instruments sous forme d'API.
L'Assessment API de JobCannon expose le moteur d'évaluation et la couche de scoring comme un service REST actif sur le palier Scale.
L'intégration comprend trois appels : POST /api/v1/assessments démarre une session et retourne l'ensemble de questions ; GET /api/v1/assessments/{session_id}/questions resert ces questions ; 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 est un simple en-tête X-API-Key (format de clé jck_live_…, scopes assessments:send et assessments:read), haché SHA-256 au repos — pas d'échange OAuth. Les sessions sont des jetons signés éphémères, il n'y a donc pas de magasin de sessions côté partenaire.
Les résultats persistent dans 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 collecté sur jobcannon.io, incluant l'intégrité des clés d'instruments en pool. La limitation de débit est par clé avec HTTP 429 + resetAt.
Disponible sur le palier Scale ($199/mo) avec une dotation d'évaluation mensuelle puis $2/évaluation en dépassement ; les partenaires white-label peuvent passer au partage de revenus. Adoptants typiques : fournisseurs de technologie RH et ATS, plates-formes LMS et EdTech, outils de services d'orientation carrière universitaire, coaching SaaS, et systèmes de gestion de cas pour organisations sans but lucratif/force de travail.
Un cycle de trois appels actif — pas un catalogue en lecture seule.
Démarrez une session avec n'importe quel slug d'instrument — créez une liste blanche de ce que votre intégration utilise.
Pour intégrer l'évaluation validée dans votre produit
L'Assessment API est l'une des fonctionnalités institutionnelles du hub JobCannon pour Business ; les équipes qui ont besoin de l'expérience intégrée pour correspondre à leur marque l'appairent avec la personnalisation white-label. Pour les intégrations spécifiques à un instrument, consultez les pages RIASEC API, Big Five API, et EQ API, ou les aperçus API psychométrique et API de test de personnalité plus larges.
Vous construisez pour une plate-forme spécifique ? Consultez l'API pour LMS & EdTech, ATS & recrutement, plates-formes de coaching, et services d'orientation carrière universitaire. Vous évaluez les fournisseurs ? Comparez-nous comme une alternative à Traitify, alternative à Pearson TalentLens, ou alternative à Hogan Assessments.
L'API d'intégration est active sur le palier Scale ($199/mo), qui comprend une dotation d'évaluation mensuelle ; les évaluations supplémentaires coûtent $2 chacune. Les partenaires white-label qui revendent nos évaluations peuvent passer au partage de revenus. Les volumes plus élevés, la résidence des données personnalisée et l'intégration technique dédiée sont scopés sous partenariat.
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.
Dites-nous votre cas d'usage d'intégration et votre volume attendu. Nous répondons avec une clé, la référence de l'endpoint, et un plan d'intégration technique.
Elle expose le moteur d'évaluation JobCannon comme un service programmable que votre produit peut appeler. Vos utilisateurs effectuent une évaluation validée — RIASEC, Big Five, EQ, Skills Audit, ou l'un de 127+ instruments — dans votre propre application, et vous récupérez un résultat scoré. La boucle complète comprend trois appels REST : POST /api/v1/assessments démarre une session et retourne l'ensemble de questions ; GET /api/v1/assessments/{session_id}/questions réextrrait ces questions 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 utilisé par le produit grand public (lib/scoring/compute.ts) s'exécute derrière l'API, donc un résultat API est identique à celui collecté sur jobcannon.io.
Chaque requête porte un en-tête 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 réextraire des questions. Les clés sont hachées SHA-256 au repos et jamais stockées en texte brut. Il n'y a pas de danse OAuth et pas d'échange de secret client : un en-tête, scopé, révocable. Une session est un jeton signé éphémère retourné par l'appel de démarrage, il n'y a donc pas de table de sessions à gérer de votre côté et pas d'interrogation.
POST /api/v1/assessments — body { test, locale?, external_user_id?, pool? } ; retourne { session_id, test, locale, question_pool, total_questions, questions[] }. GET /api/v1/assessments/{session_id}/questions — resert le payload de questions pour une session en cours (scope assessments:read). POST /api/v1/assessments/{session_id}/complete — body { 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 les vecteurs dégénérés/intacts avant le scoring. Les instruments en pool (p. ex. la batterie IQ) enfilent le pool de questions servi vers la bonne clé de scoring.
Chaque évaluation terminée est persistée dans votre organisation — la ligne de résultat est écrite avec votre api_org_id, donc elle est attribuée à vous, pas à une session de navigateur anonyme ou un compte consommateur JobCannon. L'appel complet retourne le result_id, le top_result (l'archétype principal/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 bon vous semble. La v1 actuelle retourne le résultat scoré ; la riche narration du Career Guide IA (recommandations de cours, mappage de 2 536 carrières) est une surface consommateur distincte et est scopée par partenaire, pas une réponse v1 par défaut.
Les requêtes sont limitées par clé d'API (l'identité de la clé, pas l'IP du appelant), donc une intégration bruyante ne prive jamais une autre d'air. Au-delà de la limite, vous obtenez une HTTP 429 avec un timestamp resetAt dans le body — pas d'étranglement silencieux, pas de requêtes abandonnées. Chaque appel de démarrage et de fin est mesuré pour que le décompte d'évaluations mensuelles soit 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'éléments validés et scoring — les cadres RIASEC, Big Five et EQ sont publics, mais les pools d'éléments 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'éléments ont besoin d'actualisation. L'API est le raccourci : vous appelez trois endpoints, nous tenons la psychométrie à jour. C'est actif sur le palier Scale ($199/mo), qui comprend une dotation d'évaluation mensuelle, puis $2 par évaluation au-delà du plafond. Les partenaires white-label qui revendent nos évaluations peuvent passer au partage de revenus.