Instrumentos de personalidad, puntuados en servidor, dentro de su producto.

La API expone instrumentos de personalidad validados en toda la tradición de rasgos y tipos: Big Five (Modelo de Cinco Factores, cinco puntuaciones de dimensión OCEAN), DISC (cuatro cuadrantes de comportamiento en el lugar de trabajo), HEXACO (modelo de seis factores incluyendo Honestidad-Humildad), Eneagrama (tipología de nueve tipos), y conflict-styles (cinco estilos de manejo de conflicto). Estos son parte de una biblioteca más amplia de 201+ instrumentos. Cada instrumento devuelve un top_result (el tipo, código o etiqueta de perfil dominante) y puntuaciones completas por dimensión que usted renderiza como su producto necesita.

POST /api/v1/assessments/{session_id}/complete devuelve { result_id, test, top_result, scores, question_pool }. En una llamada de Big Five, scores contiene las cinco dimensiones OCEAN como valores normalizados. En DISC, top_result es el cuadrante dominante (D, I, S o C) y scores contiene los cuatro. En Enneagram, top_result es el número del tipo dominante. La estructura es uniforme — su capa de renderizado siempre lee top_result para el titular y scores para el desglose.

Sí — es un caso de uso habitual. El usuario nunca abandona su dominio: usted renderiza el conjunto de preguntas devuelto por POST /api/v1/assessments, recoge las respuestas en su propia interfaz y las envía mediante POST al endpoint de completar. El resultado se atribuye a su organización mediante api_org_id, no a una cuenta de consumidor de JobCannon. Usted es propietario de los datos y decide cómo mostrar la tarjeta de tipo, la puntuación de compatibilidad o el mapa de equipo dentro de su producto.

Cada solicitud incluye un único encabezado X-API-Key. Las claves se emiten por organización (formato jck_live_…), con permisos assessments:send (inicio + completar) y assessments:read (recarga de preguntas), y se almacenan con hash SHA-256. No existe intercambio OAuth. Las sesiones son tokens firmados de corta duración devueltos por la llamada de inicio — sin almacén de sesiones que mantener en su lado.

La puntuación es determinista y se ejecuta en servidor. Su cliente envía índices de respuesta; el motor de puntuación conserva la clave. Los envíos degenerados — en los que un vector de respuestas predeterminadas sin modificar produciría un resultado significativo — se rechazan antes de escribir la fila de resultado. Esta es la misma capa de integridad que protege las evaluaciones del lado del consumidor.

La API de test de personalidad está disponible en el nivel Scale ($199/mo), que incluye una cuota mensual de evaluaciones. El límite cuenta evaluaciones: cada instrumento que le asignes consume una unidad. Los socios que integren y revendan resultados de personalidad con marca blanca dentro de su propio producto pueden migrar a un modelo de reparto de ingresos en lugar de la facturación por evaluación.