Crear evaluaciones
Envía candidato, puesto, nivel y, si corresponde, campaña o identificador externo. TalentScope utiliza el flujo normal de invitación y créditos.
Integration API V1
Conecta TalentScope con tu operación actual.
Tu ATS, HRIS o sistema interno puede crear evaluaciones y consultar información autorizada sin obligarte a cambiar de plataforma ni contratar un conector específico.
API keys revocablesPermisos por claveValidación antes de crearIdempotencia
Autoservicio para tu equipo técnico.
Crea una clave desde el Portal Cliente, asigna sus permisos y utiliza la documentación con ejemplos de integración.
Abrir documentación APIRuta recomendada
De la primera conexión a una evaluación real.
La API está diseñada para integraciones directas y controladas.
1Crear API key
2Probar conexión
3Validar solicitud
4Crear evaluación
5Consultar estado y resultado
Qué puedes integrar
Una API pequeña para las acciones que más importan.
La primera versión se concentra en flujos útiles y previsibles para mantener la integración simple.
Consultar evaluaciones
Obtén estado, nivel, candidato, campaña y línea de tiempo autorizada utilizando el identificador de evaluación.
Consultar resultados
Cuando existe un resultado entregable, recupera la clasificación, recomendación y evidencia complementaria permitida.
Campañas y créditos
Consulta campañas disponibles y saldo para que tu sistema valide el contexto antes de iniciar una operación.
Evita duplicados
La misma solicitud no debe crear dos evaluaciones.
Al crear una evaluación, tu sistema utiliza una Idempotency-Key única. Si necesita repetir la misma petición por un timeout o reintento, TalentScope reconoce la operación y evita duplicar la creación.
Authorization: Bearer ts_live_...
Idempotency-Key: tu-referencia-unica
Content-Type: application/json
Control de acceso
Tú decides qué puede hacer cada conexión.
Claves independientes
Usa una clave distinta para cada sistema y revoca una conexión sin afectar las demás.
Permisos definidos
Asigna sólo las capacidades necesarias: crear evaluaciones, consultar evaluaciones, resultados, campañas o créditos.
Aislamiento por organización
Cada clave trabaja únicamente dentro de la organización a la que pertenece; no utiliza un parámetro para cambiar de empresa.
Resultados autorizados
La API entrega información útil para la decisión y no expone componentes internos de evaluación que no forman parte del resultado entregable.
Para tu equipo técnico
Documentación lista para implementar.
Consulta autenticación, ejemplos GET y POST, errores, límites de uso, campañas, créditos y resultados.
¿Necesitas validar el encaje?
La integración acompaña a TalentScope; no reemplaza tu ATS o HRIS.
Empieza con la plataforma y conecta tu sistema cuando la operación lo requiera.