Instrumentos de personalidade, com pontuação server-side, dentro do seu produto.

A API expõe instrumentos de personalidade validados em tradições de traço e tipo: Big Five (Modelo de Cinco Fatores, cinco pontuações de dimensão OCEAN), DISC (quatro quadrantes de comportamento no trabalho), HEXACO (modelo de seis fatores incluindo Honestidade-Humildade), Eneagrama (tipologia de nove tipos), e conflict-styles (cinco estilos de lidar com conflito). Estes fazem parte de uma biblioteca mais ampla de 201+ instrumentos. Cada instrumento retorna um top_result (o tipo dominante, código ou rótulo de perfil) e pontuações completas por dimensão que você renderiza conforme seu produto precisar.

POST /api/v1/assessments/{session_id}/complete retorna { result_id, test, top_result, scores, question_pool }. Para uma chamada Big Five, scores contém todas as cinco dimensões OCEAN como valores normalizados. Para DISC, top_result é o quadrante dominante (D, I, S ou C) e scores contém todos os quatro. Para Enneagram, top_result é o número do tipo dominante. A estrutura é consistente — sua camada de renderização sempre lê top_result para o título e scores para o detalhamento.

Sim — este é um caso de uso comum. O usuário nunca sai do seu domínio: você renderiza o conjunto de questões retornado por POST /api/v1/assessments, coleta as respostas na sua própria interface e as envia via POST para o endpoint de conclusão. O resultado é atribuído à sua organização via api_org_id, não a uma conta de consumidor da JobCannon. Você é dono dos dados e decide como exibir o cartão de tipo, a pontuação de compatibilidade ou o mapa de equipe dentro do seu produto.

Cada requisição carrega um único cabeçalho X-API-Key. As chaves são emitidas por organização (formato jck_live_…), com escopo para assessments:send (iniciar e concluir) e assessments:read (rebuscar questões), e armazenadas com hash SHA-256. Não há troca OAuth. As sessões são tokens assinados de curta duração retornados pela chamada de início — sem armazenamento de sessão para manter do seu lado.

A pontuação é determinística e server-side. Seu cliente envia índices de resposta; o mecanismo de pontuação guarda a chave. Envios degenerados — nos quais um vetor de respostas padrão intocado produziria um resultado significativo — são rejeitados antes que uma linha de resultado seja gravada. Esta é a mesma camada de integridade que protege as avaliações do lado do consumidor.

A API de teste de personalidade está disponível no plano Scale ($199/mo), que inclui uma cota mensal de avaliações. O limite conta avaliações: cada instrumento que você atribuir consome uma unidade. Parceiros que utilizam white-label e revendem resultados de personalidade dentro do próprio produto podem migrar para um modelo de divisão de receita em vez da cobrança por avaliação.