Integre avaliações validadas no seu produto.

Expõe o motor de avaliação JobCannon como um serviço programável que seu produto pode chamar. Seus usuários realizam uma avaliação validada — RIASEC, Big Five, EQ, Auditoria de Habilidades ou qualquer um dos 138+ instrumentos — dentro do seu próprio aplicativo, e você recebe um resultado pontuado de volta. O loop completo são três chamadas REST: POST /api/v1/assessments inicia uma sessão e retorna o conjunto de questões; GET /api/v1/assessments/{session_id}/questions refetch essas questões se precisar novamente; POST /api/v1/assessments/{session_id}/complete envia as respostas, pontua no servidor e retorna o resultado. O mesmo caminho de código de pontuação que o produto consumidor usa (lib/scoring/compute.ts) é executado atrás da API, então um resultado de API é idêntico ao realizado em jobcannon.io.

Cada solicitação carrega um cabeçalho X-API-Key. Sua chave se parece com jck_live_… e é emitida por organização com escopos — assessments:send permite iniciar e concluir sessões, assessments:read permite refetch de questões. As chaves são hash SHA-256 em repouso e nunca armazenadas em texto simples. Não há dança OAuth e sem troca de segredo do cliente: um cabeçalho, com escopo, revogável. Uma sessão é um token assinado de curta duração retornado pela chamada de início, portanto não há tabela de sessão para gerenciar no seu lado e sem polling.

POST /api/v1/assessments — corpo { test, locale?, external_user_id?, pool? }; retorna { session_id, test, locale, question_pool, total_questions, questions[] }. GET /api/v1/assessments/{session_id}/questions — retorna o payload de questões para uma sessão em andamento (escopo assessments:read). POST /api/v1/assessments/{session_id}/complete — corpo { answers: number[], external_user_id? } onde as respostas são índices de opção na ordem em que as questões foram fornecidas; retorna { result_id, test, top_result, scores, question_pool }. As respostas são validadas por comprimento e para vetores degenerados/intocados antes da pontuação. Os instrumentos agrupados (por ex., a bateria de QI) passam o pool de questões servido através da chave de pontuação correta.

Cada avaliação concluída persiste para sua organização — a linha de resultado é escrita com seu api_org_id, portanto é atribuída a você, não a uma sessão anônima do navegador ou uma conta de consumidor JobCannon. A chamada completa retorna o result_id, o top_result (o arquétipo/tipo/código de manchete para esse instrumento) e os scores por dimensão completos. Você armazena o result_id e renderiza o resultado dentro do seu produto como preferir. O v1 atual retorna o resultado pontuado; a narrativa mais rica do Guia de Carreira com IA (recomendações de curso, mapeamento de 2.521 carreira) é uma superfície de consumidor separada e tem escopo por parceiro, não uma resposta v1 padrão.

As solicitações são limitadas por taxa por chave de API (a identidade da chave, não o IP do chamador), portanto uma integração barulhenta nunca prejudica outra. Acima do limite, você recebe um HTTP 429 com um timestamp resetAt no corpo — sem restrição silenciosa, sem solicitações descartadas. Cada chamada de início e conclusão é medida, portanto sua contagem mensal de avaliações é precisa para faturamento.

As equipes que constroem avaliação de carreira internamente geralmente subestimam dois custos. (1) Bancos de itens validados e pontuação — os frameworks RIASEC, Big Five e EQ são públicos, mas pools de itens validados e algoritmos de pontuação direcional não são; construir e validar os seus próprios leva anos e dezenas de milhares de administrações. (2) Manutenção — os instrumentos variam e os bancos de itens precisam de atualização. A API é o atalho: você chama três endpoints, mantemos a psicometria atualizada. Está ativo no plano Scale ($199/mo), que inclui uma provisão mensal de avaliações, depois $2 por avaliação acima do limite. Parceiros com marca própria que revendem nossas avaliações podem mudar para compartilhamento de receita.