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

La API expone instrumentos de personalidad validados de las tradiciones de rasgos y tipos: Big Five (Modelo de los Cinco Factores, cinco puntuaciones de dimensión OCEAN), DISC (cuatro cuadrantes de comportamiento laboral), HEXACO (modelo de seis factores que incluye Honestidad-Humildad), Enneagram (tipología de nueve tipos) y estilos de conflicto (cinco modos de Thomas-Kilmann). Estos forman parte de una biblioteca más amplia de más de 179 instrumentos. Cada instrumento devuelve un top_result (el tipo dominante, código o etiqueta de perfil) y puntuaciones completas por dimensión que usted renderiza según las necesidades de su producto.

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. La gestión de ítems direccionales (socialmente deseables o de falsificación positiva) está integrada en el motor. 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.