Saltar al contenido principal

API de Perfil Compartido

El endpoint de Perfil Compartido proporciona información completa del candidato dentro de un contexto de posición específico, combinando detalles personales, resultados de evaluación y datos detallados de rendimiento de pruebas.

Endpoint Disponible​

EndpointMétodoDescripción
/shared/{candidate_id}/{position_id}GETObtener perfil completo del candidato e información de posición

Propósito del Endpoint​

Este endpoint proporciona una vista completa de evaluación del candidato combinando:

  • Información Personal: Nombre, correo electrónico, teléfono y detalles de contacto
  • Detalles del Currículum: Experiencia, habilidades, educación y propiedades del currículum analizadas
  • Resultados de Evaluación: Puntuaciones generales, evaluaciones generadas por IA y datos específicos de la posición
  • Rendimiento de Pruebas: Resultados detallados a nivel de pregunta con respuestas del candidato y corrección
  • Acceso a Archivos: URLs de avatar y archivo de currículum para registros completos del candidato

Casos de Uso​

Preparación de Entrevistas​

  • Acceder a perfiles completos de candidatos antes de entrevistas
  • Revisar resultados detallados de pruebas y métricas de rendimiento
  • Analizar coincidencias de habilidades y experiencia para la posición

Evaluación de Candidatos​

  • Obtener vista general completa de evaluación incluyendo insights generados por IA
  • Comparar rendimiento del candidato a través de diferentes componentes de prueba
  • Acceder tanto a puntuaciones cuantitativas como a datos de evaluación cualitativa

Reportes y Documentación​

  • Generar reportes detallados de candidatos con toda la información disponible
  • Crear resúmenes de evaluación completos
  • Documentar decisiones de contratación con contexto completo del candidato

Estructura de Respuesta​

Sección de Perfil​

Contiene información personal del candidato y detalles del currículum:

{
  "profile": {
    "personal_info": {
      "id": "candidate-uuid",
      "name": "John Smith",
      "email": "john.smith@example.com",
      "phone": "+1-555-123-4567"
    },
    "last_activity": "2023-06-05T14:30:00Z",
    "resume_properties": {
      "language": "English",
      "location_country": "United States",
      "location_city": "Boston",
      "latest_job_title": "Senior Software Engineer"
    },
    "skills": [
      { "skill": "Python", "years_experience": "5+" },
      { "skill": "React", "years_experience": "3" }
    ],
    "avatar_url": "https://storage.example.com/avatars/candidate.jpg",
    "resume_urls": ["https://storage.example.com/resumes/resume.pdf"]
  }
}

Sección de Pruebas​

Proporciona resultados detallados de pruebas con datos a nivel de pregunta:

{
  "tests": [
    {
      "id": "test123",
      "name": "Python Programming",
      "type": "Technical Skills",
      "sub_type": "Coding",
      "score": 85,
      "questions": [
        {
          "id": "q1",
          "question": "What is a Python decorator?",
          "type": "Multiple Choice",
          "options": ["Option A", "Option B", "Option C"],
          "candidate_answer": "A function that takes another function as an argument",
          "is_correct": "true"
        }
      ]
    }
  ]
}

Sección de Resultados de Posición​

Contiene información de evaluación específica de la posición:

{
  "position_results": {
    "id": "assessment123",
    "name": "Software Engineer Assessment",
    "job_title": "Senior Python Developer",
    "status": "Completed",
    "created_at": "2023-06-01T10:00:00Z",
    "completed_at": "2023-06-02T15:30:00Z",
    "ai_score": "87",
    "ai_score_desc": "Strong match for the position",
    "overall_score": 85,
    "salary_expectation": 120000,
    "salary_expectation_currency": "USD"
  }
}

Datos Disponibles​

Información Personal​

  • Detalles básicos de contacto (nombre, correo electrónico, teléfono)
  • Marca de tiempo de última actividad
  • URL de imagen de avatar

Análisis de Currículum​

  • Propiedades del currículum analizadas (ubicación, título del trabajo, idioma)
  • Habilidades extraídas con años de experiencia
  • URLs de archivo de currículum para acceso a documentos
  • Contenido de texto crudo del currículum

Rendimiento de Evaluación​

  • Puntuación general de evaluación
  • Puntuación y descripción generadas por IA
  • Estado y cronología de evaluación
  • Expectativas salariales y moneda

Resultados de Pruebas​

  • Puntuaciones y rendimiento de pruebas individuales
  • Detalles completos de preguntas y respuestas
  • Indicadores de corrección de respuestas
  • Categorización de pruebas (tipo y subtipo)

Requisitos de Acceso​

Autenticación​

  • Se requiere clave API válida para todas las solicitudes
  • El candidato debe estar asociado con una posición en tu organización
  • La posición debe pertenecer a tu organización

Permisos​

  • Control de acceso basado en organización
  • Validación de propiedad de posición
  • Verificación de asociación candidato-posición

Respuestas de Error​

403 - Acceso Denegado​

Ocurre cuando:

  • La posición no pertenece a tu organización
  • El candidato no está asociado con la posición especificada
  • Permisos insuficientes para acceder a los datos

404 - No Encontrado​

Ocurre cuando:

  • El ID del candidato no existe
  • El ID de la posición no existe
  • La asociación candidato-posición no existe

500 - Error del Servidor​

Ocurre cuando:

  • Problemas de conectividad de base de datos
  • Errores inesperados del sistema
  • Fallas en el procesamiento de datos

Notas de Implementación​

Completitud de Datos​

  • No todos los candidatos pueden tener información de perfil completa
  • Las propiedades del currículum dependen del procesamiento exitoso de IA
  • Los datos de habilidades requieren la finalización del análisis del currículum
  • Los resultados de pruebas solo están disponibles después de la finalización de la evaluación

URLs de Archivos​

  • Las URLs de avatar y currículum están pre-firmadas para acceso seguro
  • Las URLs tienen tiempos de expiración por seguridad
  • Los archivos se almacenan de forma segura con controles de acceso basados en organización

Consideraciones de Rendimiento​

  • Este endpoint devuelve datos completos y puede tener tiempos de respuesta más largos
  • Considera hacer caché de las respuestas para perfiles de candidatos accedidos frecuentemente
  • Usa configuraciones de timeout apropiadas para llamadas a la API

Este endpoint sirve como una fuente de datos completa para evaluación de candidatos, proporcionando toda la información disponible en una sola llamada a la API para flujos de trabajo completos de evaluación de candidatos.