Motore di valutazione programmabile
Tre chiamate REST — start, questions, complete. Autenticazione X-API-Key, scoring lato server, risultati attribuiti alla tua organizzazione. RIASEC, Big Five, EQ, Skills Audit e 133+ strumenti come API.
L'API Valutazioni JobCannon espone il motore di valutazione e il layer di scoring come servizio REST live sul tier Scale.
L'integrazione prevede tre chiamate: POST /api/v1/assessments avvia una sessione e restituisce il set di domande; GET /api/v1/assessments/{session_id}/questions re-serve quelle domande; POST /api/v1/assessments/{session_id}/complete invia le risposte, le valuta lato server e restituisce { result_id, top_result, scores }.
L'autenticazione è un singolo header X-API-Key (formato chiave jck_live_…, scopes assessments:send e assessments:read), hashato SHA-256 a riposo — nessuno scambio OAuth. Le sessioni sono token firmati a breve durata, quindi non c'è alcun session store dal lato partner.
I risultati persistono all'organizzazione del partner tramite api_org_id. Lo scoring riutilizza lo stesso percorso di codice del prodotto consumer, quindi un risultato erogato tramite API è identico a uno completato su jobcannon.io, inclusa l'integrità della chiave dello strumento in pool. Il rate limiting è per chiave con HTTP 429 + resetAt.
Disponibile sul tier Scale ($199/mo) con una quota mensile di valutazioni e poi $2/valutazione per il superamento; i partner white-label possono passare a revenue-share. Utenti tipici: fornitori HR-tech e ATS, piattaforme LMS e EdTech, strumenti di orientamento universitario, SaaS di coaching e sistemi di case-management per enti no-profit/workforce.
Un ciclo di vita live a tre chiamate — non un catalogo di sola lettura.
Avvia una sessione con qualsiasi slug di strumento — crea una whitelist di ciò che la tua integrazione usa.
Per incorporare valutazioni validate nel tuo prodotto
L'API Valutazioni è una delle funzionalità istituzionali su JobCannon per Business hub; i team che hanno bisogno che l'esperienza incorporata corrisponda al loro brand la combinano con personalizzazione white-label. Per integrazioni specifiche dello strumento, vedi RIASEC API, Big Five API, e EQ API pagine, o le più ampie API psicometrica e API test di personalità overview.
Costruisci per una piattaforma specifica? Vedi l'API per LMS e EdTech, ATS e recruiting, piattaforme di coaching, e servizi di carriera universitari. Valutando vendor? Confrontaci come alternativa a Traitify, Pearson TalentLens, o Hogan Assessments.
L'API embed è live sul tier Scale ($199/mo), che include una quota mensile di valutazioni; le valutazioni aggiuntive sono $2 ognuna. I partner white-label che rivendono le nostre valutazioni possono passare a un revenue-share. Volumi più alti, residenza dati personalizzata e onboarding tecnico dedicato sono scoped sotto partnership.
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.
Raccontaci il tuo caso d'uso di integrazione e il tuo volume previsto. Rispondiamo con una chiave, il riferimento dell'endpoint e un piano di onboarding tecnico.
Espone il motore di valutazione JobCannon come servizio programmabile che il tuo prodotto può chiamare. I tuoi utenti completano una valutazione validate — RIASEC, Big Five, EQ, Skills Audit o uno dei 133+ strumenti — dentro la tua app, e tu ricevi indietro un risultato scored. L'intero loop è tre chiamate REST: POST /api/v1/assessments avvia una sessione e restituisce il set di domande; GET /api/v1/assessments/{session_id}/questions re-fetch quelle domande se hai bisogno di averle di nuovo; POST /api/v1/assessments/{session_id}/complete invia le risposte, le valuta lato server e restituisce il risultato. Lo stesso percorso di codice di scoring che usa il prodotto consumer (lib/scoring/compute.ts) gira dietro l'API, quindi un risultato API è identico a uno completato su jobcannon.io.
Ogni richiesta porta un header X-API-Key. La tua chiave assomiglia a jck_live_… ed è rilasciata per organizzazione con scope — assessments:send ti consente di avviare e completare sessioni, assessments:read ti consente di ri-fetch domande. Le chiavi sono hashate SHA-256 a riposo e mai memorizzate in testo semplice. Non c'è nessun scambio OAuth e nessun scambio di client-secret: un header, scoped, revocabile. Una sessione è un token firmato a breve durata restituito dalla chiamata di start, quindi non c'è alcuna tabella di sessione da gestire dal tuo lato e nessun polling.
POST /api/v1/assessments — body { test, locale?, external_user_id?, pool? }; restituisce { session_id, test, locale, question_pool, total_questions, questions[] }. GET /api/v1/assessments/{session_id}/questions — re-serve il payload delle domande per una sessione in corso (scope assessments:read). POST /api/v1/assessments/{session_id}/complete — body { answers: number[], external_user_id? } dove le risposte sono indici di opzione nell'ordine in cui le domande sono state servite; restituisce { result_id, test, top_result, scores, question_pool }. Le risposte sono validate per lunghezza e per vettori degenerati/non toccati prima dello scoring. Gli strumenti in pool (es. la batteria IQ) filano il pool di domande servito attraverso la chiave di scoring corretta.
Ogni valutazione completata persiste nell'organizzazione — la riga del risultato è scritta con il tuo api_org_id, quindi è attribuita a te, non a una sessione del browser anonimo o a un account consumer JobCannon. La chiamata di complete restituisce il result_id, il top_result (l'archetipo/tipo/codice di titolo per quello strumento) e i punteggi completi per dimensione. Memorizzi il result_id e renderizzi l'esito dentro il tuo prodotto come preferisci. L'attuale v1 restituisce il risultato scored; la narrativa più ricca della Guida Carriera AI (raccomandazioni di corsi, mapping di 2521 carriere) è una superficie consumer separata e è scoped per partner, non una risposta default v1.
Le richieste sono rate-limited per chiave API (l'identità della chiave, non l'IP del chiamante), quindi un'integrazione rumorosa non affama mai un'altra. Oltre il limite ricevi HTTP 429 con un timestamp resetAt nel body — nessun throttling silenzioso, nessuna richiesta persa. Ogni chiamata di start e complete è misurata così il tuo conteggio mensile di valutazioni è accurato per la fatturazione.
I team che creano career-assessment interno di solito sottovalutano due costi. (1) Banche di item validate e scoring — i framework RIASEC, Big Five ed EQ sono pubblici, ma i pool di item validate e gli algoritmi di scoring direzionali no; costruirne e validarne uno richiede anni e decine di migliaia di somministrazioni. (2) Manutenzione — gli strumenti derivano e le banche di item hanno bisogno di refresh. L'API è la scorciatoia: chiami tre endpoint, noi manteniamo la psicometria attuale. È live sul tier Scale ($199/mo), che include una quota mensile di valutazioni, poi $2 per valutazione oltre il limite. I partner white-label che rivendono le nostre valutazioni possono passare a un revenue-share.