Visão Geral da API de Posições
A API de Posições permite gerenciar posições de trabalho, enviar currículos de candidatos, convidar candidatos para avaliações e recuperar resultados abrangentes e análises.
Endpoints Disponíveis
Gerenciamento de Posições
| Endpoint | Método | Descrição |
|---|
/positions/{position_id} | GET | Obter informações da posição com candidatos |
/positions/{position_id}/upload-resume | POST | Enviar um currículo para uma posição |
/positions/retrieve-ai-score | POST | Obter pontuação de IA para um currículo |
Convite e Gerenciamento de Candidatos
| Endpoint | Método | Descrição |
|---|
/positions/invite/{position_id} | POST | Convidar um candidato para uma posição |
/positions/re-invite/{position_id}/{candidate_id} | POST | Reenviar convite para um candidato |
/positions/{position_id}/{candidate_id}/status | PUT | Alterar status do candidato na posição |
Resultados e Análises
| Endpoint | Método | Descrição |
|---|
/positions/{position_id}/{candidate_id}/results | GET | Obter resultados do candidato para uma posição específica |
/positions/{position_id}/{candidate_id}/videos | GET | Obter todos os arquivos de vídeo do teste do candidato |
/positions/{position_id}/{candidate_id}/videos/{video_id}/download | GET | Baixar um arquivo de vídeo específico |
Fluxo de Trabalho de Posições
Processo de Avaliação Padrão
- Envio de Currículo: Enviar currículos de candidatos para posições específicas usando o endpoint de upload
- Análise de IA: Análise automática do currículo e extração de habilidades ocorre após o envio
- Convite de Candidato: Enviar convites por e-mail para candidatos usando o endpoint de convite
- Conclusão da Avaliação: Candidatos completam testes e avaliações através da plataforma
- Gerenciamento de Status: Atualizar status do candidato através do pipeline de contratação usando o endpoint de status
- Recuperação de Resultados: Acessar pontuações, resultados detalhados e gravações de vídeo através dos endpoints de resultados
Opções de Upload
- Vincula o currículo a um candidato existente ou cria um novo registro de candidato
- Associa o candidato com a posição automaticamente
- Aciona o processamento de IA para análise do currículo
Sem E-mail do Candidato
- Cria um registro de candidato placeholder
- A IA processa o currículo e extrai informações do candidato
- Detalhes do candidato são preenchidos durante o processamento
Gerenciamento de Status de Candidatos
Valores de Status Disponíveis
| Status | Descrição | Caso de Uso |
|---|
Invited | Candidato foi convidado mas não começou | Convite inicial enviado |
In Progress | Candidato começou a avaliação | Avaliação em andamento |
Completed | Candidato terminou a avaliação | Pronto para revisão |
Rejected | Candidato foi rejeitado | Não seguirá adiante |
Interviewing | Candidato está na fase de entrevista | Passando para próxima etapa |
Hired | Candidato foi contratado | Conclusão bem-sucedida |
Atualizações de Status
- Mudanças de status são rastreadas com timestamps
- Use o endpoint PUT de status para atualizar o progresso do candidato
- Atualizações de status ajudam a rastrear candidatos através do seu pipeline de contratação
Suporte para Upload de Arquivos
- Documentos PDF
- Microsoft Word (.doc, .docx)
Processo de Upload
- Arquivos são validados automaticamente no upload
- Conteúdo de texto é extraído para análise de IA
- Dados do currículo são analisados e estruturados para fácil acesso
- IA gera pontuações de candidatos baseadas nos requisitos da posição
Resultados e Análises
Resultados de Testes
- Acessar pontuações gerais em todos os testes
- Obter dados de desempenho de testes individuais
- Visualizar resultados detalhados em nível de pergunta incluindo respostas do candidato e correção
Gravações de Vídeo
- Recuperar arquivos de vídeo gravados durante avaliações (se habilitado)
- Acessar transcrições e análise de idioma
- Baixar arquivos de vídeo individuais para revisão detalhada