Resumen de la API de Posiciones
La API de Posiciones te permite gestionar puestos de trabajo, subir currículums de candidatos, invitar candidatos a evaluaciones y obtener resultados completos y análisis.
Endpoints Disponibles
Gestión de Posiciones
| Endpoint | Método | Descripción |
|---|
/positions/{position_id} | GET | Obtener información de posición con candidatos |
/positions/{position_id}/upload-resume | POST | Subir un currículum para una posición |
/positions/retrieve-ai-score | POST | Obtener puntuación de IA para un currículum |
Invitación y Gestión de Candidatos
| Endpoint | Método | Descripción |
|---|
/positions/invite/{position_id} | POST | Invitar un candidato a una posición |
/positions/re-invite/{position_id}/{candidate_id} | POST | Re-enviar invitación a un candidato |
/positions/{position_id}/{candidate_id}/status | PUT | Cambiar estado del candidato en la posición |
Resultados y Analítica
| Endpoint | Método | Descripción |
|---|
/positions/{position_id}/{candidate_id}/results | GET | Obtener resultados del candidato para una posición específica |
/positions/{position_id}/{candidate_id}/videos | GET | Obtener todos los archivos de video de la prueba del candidato |
/positions/{position_id}/{candidate_id}/videos/{video_id}/download | GET | Descargar un archivo de video específico |
Flujo de Trabajo de Posiciones
Proceso de Evaluación Estándar
- Subida de Currículum: Subir currículums de candidatos a posiciones específicas usando el endpoint de subida
- Análisis de IA: El análisis automático del currículum y extracción de habilidades ocurre después de la subida
- Invitación de Candidato: Enviar invitaciones por correo electrónico a candidatos usando el endpoint de invitación
- Finalización de Evaluación: Los candidatos completan pruebas y evaluaciones a través de la plataforma
- Gestión de Estado: Actualizar el estado del candidato a través del pipeline de contratación usando el endpoint de estado
- Obtención de Resultados: Acceder a puntuaciones, resultados detallados y grabaciones de video a través de endpoints de resultados
Opciones de Subida
Con Correo Electrónico del Candidato
- Vincula el currículum a un candidato existente o crea un nuevo registro de candidato
- Asocia el candidato con la posición automáticamente
- Activa el procesamiento de IA para análisis del currículum
Sin Correo Electrónico del Candidato
- Crea un registro de candidato de marcador de posición
- La IA procesa el currículum y extrae información del candidato
- Los detalles del candidato se completan durante el procesamiento
Gestión de Estado de Candidatos
Valores de Estado Disponibles
| Estado | Descripción | Caso de Uso |
|---|
Invited | El candidato ha sido invitado pero no ha comenzado | Invitación inicial enviada |
In Progress | El candidato ha comenzado la evaluación | Evaluación en progreso |
Completed | El candidato ha terminado la evaluación | Listo para revisión |
Rejected | El candidato ha sido rechazado | No continuará |
Interviewing | El candidato está en fase de entrevista | Pasando a la siguiente etapa |
Hired | El candidato ha sido contratado | Finalización exitosa |
Actualizaciones de Estado
- Los cambios de estado se rastrean con marcas de tiempo
- Usa el endpoint PUT de estado para actualizar el progreso del candidato
- Las actualizaciones de estado ayudan a rastrear candidatos a través de tu pipeline de contratación
Soporte para Subida de Archivos
- Documentos PDF
- Microsoft Word (.doc, .docx)
Proceso de Subida
- Los archivos se validan automáticamente al subirlos
- El contenido de texto se extrae para análisis de IA
- Los datos del currículum se analizan y estructuran para fácil acceso
- La IA genera puntuaciones de candidatos basadas en los requisitos de la posición
Resultados y Analítica
Resultados de Pruebas
- Acceder a puntuaciones generales en todas las pruebas
- Obtener datos de rendimiento de pruebas individuales
- Ver resultados detallados a nivel de pregunta incluyendo respuestas del candidato y corrección
Grabaciones de Video
- Obtener archivos de video grabados durante evaluaciones (si están habilitadas)
- Acceder a transcripciones y análisis de idioma
- Descargar archivos de video individuales para revisión detallada