Strumenti di personalità, con scoring lato server, nel tuo prodotto.

L'API espone strumenti di personalità convalidati attraverso tradizioni di tratti e tipi: Big Five (Five-Factor Model, cinque punteggi di dimensione OCEAN), DISC (quattro quadranti di comportamento sul posto di lavoro), HEXACO (modello a sei fattori inclusa l'Onestà-Umiltà), Enneagram (tipologia di nove tipi), e conflict-styles (cinque stili di gestione dei conflitti). Questi fanno parte di una biblioteca più ampia di 201+ strumenti. Ogni strumento restituisce un top_result (il tipo dominante, il codice, o l'etichetta del profilo) e i punteggi per dimensione completi che renderizzi come il tuo prodotto necessita.

POST /api/v1/assessments/{session_id}/complete restituisce { result_id, test, top_result, scores, question_pool }. Per una chiamata Big Five, scores contiene tutte e cinque le dimensioni OCEAN come valori normalizzati. Per DISC, top_result è il quadrante dominante (D, I, S o C) e scores contiene tutti e quattro. Per l'Enneagram, top_result è il numero del tipo dominante. La struttura è coerente — il tuo layer di rendering legge sempre top_result per il titolo e scores per il dettaglio.

Sì — è un caso d'uso molto comune. L'utente non lascia mai il tuo dominio: tu visualizzi il set di domande restituito da POST /api/v1/assessments, raccogli le risposte nella tua interfaccia e le invii all'endpoint di completamento. Il risultato è attribuito alla tua organizzazione tramite api_org_id, non a un account consumer JobCannon. Sei tu il proprietario dei dati e decidi come mostrare la scheda di tipo, il punteggio di compatibilità o la mappa del team nel tuo prodotto.

Ogni richiesta include un singolo header X-API-Key. Le chiavi vengono emesse per organizzazione (formato jck_live_…), con scope assessments:send (avvio + completamento) e assessments:read (recupero domande), e hashing SHA-256 a riposo. Non è previsto alcuno scambio OAuth. Le sessioni sono token firmati a breve durata restituiti dalla chiamata di avvio — nessun session store da mantenere sul tuo lato.

Lo scoring è deterministico e lato server. Il client invia gli indici delle risposte; il motore di scoring detiene la chiave. Le risposte degeneri — in cui un vettore di risposte predefinite non modificato produrrebbe un risultato significativo — vengono rifiutate prima che venga scritta una riga di risultato. Si tratta dello stesso livello di integrità che protegge le valutazioni lato consumer.

L'API per test di personalità è attiva sul piano Scale ($199/mo), che include una quota mensile di valutazioni. Il limite conta le valutazioni: ogni strumento che assegni consuma un'unità. I partner che integrano e rivendono i risultati di personalità con il proprio brand possono passare a un modello revenue-share anziché alla fatturazione per valutazione.