Motor de evaluación programable
Tres llamadas REST — inicio, preguntas, completar. Autenticación X-API-Key, puntuación en servidor, resultados atribuidos a tu organización. RIASEC, Big Five, EQ, Skills Audit y 127+ instrumentos como API.
El Assessment API de JobCannon expone el motor de evaluación y la capa de puntuación como un servicio REST activo en el tier Scale.
La integración consta de tres llamadas: POST /api/v1/assessments inicia una sesión y devuelve el conjunto de preguntas; GET /api/v1/assessments/{session_id}/questions sirve nuevamente esas preguntas; POST /api/v1/assessments/{session_id}/complete envía las respuestas, las puntúa en el servidor y devuelve { result_id, top_result, scores }.
La autenticación es un único encabezado X-API-Key (formato de clave jck_live_…, alcances assessments:send y assessments:read), hasheada con SHA-256 en reposo — sin intercambio OAuth. Las sesiones son tokens firmados de corta duración, por lo que no hay almacenamiento de sesiones en tu lado.
Los resultados persisten en la organización del partner mediante api_org_id. La puntuación reutiliza la misma ruta de código que el producto de consumidor, por lo que un resultado entregado por API es idéntico a uno realizado en jobcannon.io, incluida la integridad de clave de instrumentos agrupados. La limitación de velocidad es por clave con HTTP 429 + resetAt.
Disponible en el tier Scale ($199/mo) con una asignación mensual de evaluaciones y luego $2/evaluación de excedente; los partners de etiqueta blanca pueden pasar a ingresos compartidos. Usuarios típicos: proveedores de HR-tech y ATS, plataformas LMS y EdTech, herramientas de orientación profesional universitaria, SaaS de coaching, y sistemas de gestión de casos para ONG/fuerza laboral.
Un ciclo de vida activo de tres llamadas — no un catálogo de solo lectura.
Inicia una sesión con cualquier slug de instrumento — whitelist lo que tu integración usa.
Para integrar evaluaciones validadas en tu producto
El Assessment API es una de las características institucionales en el hub JobCannon for Business; los equipos que necesitan que la experiencia integrada coincida con su marca lo emparejan con temas de etiqueta blanca. Para integraciones específicas de instrumentos, ve RIASEC API, Big Five API, y EQ API, o las visiones generales de API psicométrica y API de prueba de personalidad.
¿Construyendo para una plataforma específica? Ve el API para LMS y EdTech, ATS y reclutamiento, plataformas de coaching, y servicios de carrera universitarios. ¿Evaluando proveedores? Compáranos como una alternativa a Traitify, alternativa a Pearson TalentLens, o alternativa a Hogan Assessments.
El API de integración está activo en el tier Scale ($199/mo), que incluye una asignación mensual de evaluaciones; las evaluaciones adicionales son $2 cada una. Los partners de etiqueta blanca que revenden nuestras evaluaciones pueden pasar a ingresos compartidos. Volúmenes más altos, residencia de datos personalizada y onboarding técnico dedicado están limitados bajo partnership.
Always free for micro-teams
For solo coaches and small HR
For startups, teams and HR
For agencies, L&D and scale-ups
For 200+ person companies
Self-serve checkout via Stripe — major cards, Apple Pay, Google Pay, Link. Cancel anytime; 14-day money-back on Starter, Team, and Scale. Enterprise via the contact form below.
Cuéntanos tu caso de uso de integración y tu volumen esperado. Respondemos con una clave, la referencia del endpoint y un plan de onboarding técnico.
Expone el motor de evaluación de JobCannon como un servicio programable que tu producto puede llamar. Tus usuarios realizan una evaluación validada — RIASEC, Big Five, EQ, Skills Audit, o cualquiera de los 127+ instrumentos — dentro de tu propia app, y recibes un resultado puntuado. El bucle completo consta de tres llamadas REST: POST /api/v1/assessments inicia una sesión y devuelve el conjunto de preguntas; GET /api/v1/assessments/{session_id}/questions re-obtiene esas preguntas si las necesitas nuevamente; POST /api/v1/assessments/{session_id}/complete envía las respuestas, las puntúa en el servidor y devuelve el resultado. La misma ruta de código de puntuación que usa el producto de consumidor (lib/scoring/compute.ts) se ejecuta detrás de la API, por lo que un resultado de API es idéntico a uno realizado en jobcannon.io.
Cada solicitud lleva un encabezado X-API-Key. Tu clave se ve como jck_live_… y se emite por organización con alcances — assessments:send te permite iniciar y completar sesiones, assessments:read te permite re-obtener preguntas. Las claves se hashean con SHA-256 en reposo y nunca se almacenan en texto plano. No hay un intercambio OAuth y ningún intercambio de secreto de cliente: un encabezado, limitado, revocable. Una sesión es un token firmado de corta duración devuelto por la llamada de inicio, por lo que no hay tabla de sesiones que gestionar en tu lado y sin polling.
POST /api/v1/assessments — cuerpo { test, locale?, external_user_id?, pool? }; devuelve { session_id, test, locale, question_pool, total_questions, questions[] }. GET /api/v1/assessments/{session_id}/questions — sirve nuevamente la carga de preguntas para una sesión en curso (alcance assessments:read). POST /api/v1/assessments/{session_id}/complete — cuerpo { answers: number[], external_user_id? } donde las respuestas son índices de opción en el orden en que se sirvieron las preguntas; devuelve { result_id, test, top_result, scores, question_pool }. Las respuestas se validan por longitud y por vectores degenerados/sin tocar antes de puntuar. Los instrumentos agrupados (por ejemplo, la batería IQ) canalizan el conjunto de preguntas servido a través de la clave de puntuación correcta.
Cada evaluación completada persiste en tu organización — la fila de resultado se escribe con tu api_org_id, por lo que se te atribuye a ti, no a una sesión de navegador anónima o a una cuenta de consumidor de JobCannon. La llamada de completar devuelve el result_id, el top_result (el arquetipo/tipo/código principal para ese instrumento) y las puntuaciones completas por dimensión. Almacenas el result_id y renderizas el resultado dentro de tu producto como prefieras. El v1 actual devuelve el resultado puntuado; la narrativa más rica de Guía de Carrera por IA (recomendaciones de cursos, mapeo de 2536 carreras) es una superficie de consumidor separada y está limitada por partner, no es una respuesta v1 predeterminada.
Las solicitudes se limitan por clave de API (la identidad de la clave, no la IP del llamador), por lo que una integración ruidosa nunca privará a otra. Por encima del límite recibes un HTTP 429 con un timestamp resetAt en el cuerpo — sin limitación silenciosa, sin solicitudes descartadas. Cada llamada de inicio y completar se mide para que tu recuento mensual de evaluaciones sea exacto para la facturación.
Los equipos que construyen evaluación de carrera internamente suelen subestimar dos costos. (1) Bancos de artículos validados y puntuación — los marcos RIASEC, Big Five y EQ son públicos, pero los conjuntos de artículos validados y los algoritmos de puntuación direccional no lo son; construir y validar los tuyos toma años y decenas de miles de administraciones. (2) Mantenimiento — los instrumentos cambian y los bancos de artículos necesitan actualización. La API es el atajo: llamas tres endpoints, nosotros mantenemos la psicometría actual. Está activa en el tier Scale ($199/mo), que incluye una asignación mensual de evaluaciones, luego $2 por evaluación por encima del límite. Los partners de etiqueta blanca que revenden nuestras evaluaciones pueden pasar a ingresos compartidos en su lugar.