ATS Integration: como funciona a nova API da GeekHunter

Acesse aqui o artigo de como fazer a integração.

Gerenciar processos seletivos em múltiplos sistemas sempre foi um desafio comum para as equipes de recrutamento. Fluxos duplicados, retrabalho e falta de sincronização acabam impactando diretamente a produtividade e a experiência dos candidatos.

Pensando nisso, apresentamos o ATS Integration, a nova API da GeekHunter disponível para clientes Standard e Premium.

O que é o ATS Integration?

O ATS Integration é uma API REST que permite integrar o seu ATS (Applicant Tracking System) com a GeekHunter.

Na prática, isso significa que você pode:

Ou seja: menos retrabalho e mais eficiência no seu fluxo de recrutamento.

---

 Como funciona na prática?

A divisão de responsabilidades fica simples:

• GeekHunter: atração e qualificação técnica de candidatos
• Seu ATS: gestão do pipeline (entrevistas, etapas e contratação)

A API permite que seu sistema consulte e interaja com os dados da GeekHunter sem precisar sair do seu ambiente atual.

---

Funcionalidades disponíveis (versão 1.0.0)

Nesta primeira versão, você já pode:

1. Listar todas as vagas da empresa

Recupere todas as vagas publicadas na GeekHunter diretamente no seu ATS.

2. Buscar dados de uma vaga específica

Consulte informações detalhadas de uma vaga usando o job_id.

3. Listar candidatos de uma vaga

Acesse todos os candidatos que aplicaram para uma vaga específica.

4. Rejeitar candidatos

Realize a rejeição de um candidato diretamente via API, mantendo seu ATS sincronizado com a GeekHunter.

---

 Autenticação

Todas as requisições utilizam autenticação via API Key:

Authorization: Bearer {SUA_API_KEY}

Como gerar sua API Key:

1. Acesse o dashboard da GeekHunter
2. Vá em Configurações → Integrações → API Keys
3. Clique em Gerar nova chave
4. Armazene a chave com segurança (ela só é exibida uma vez)

 

---

 Boas práticas de segurança

 

---

Padrões da API

Formato das requisições

• Protocolo: HTTPS
• Formato: JSON (application/json)
• Encoding: UTF-8

---

 Datas e horários

• Formato: ISO 8601 (UTC)
• Exemplo:

2026-03-01T09:00:00Z

Campos comuns:

• created_at
• updated_at
• applied_at

---

 Identificadores

Campo	Descrição
job_id	ID da vaga (10 caracteres)
application_id	ID da candidatura

Esses IDs são públicos e não correspondem aos IDs internos do seu sistema.

---

Paginação

Endpoints de listagem utilizam:

• page (padrão: 1)
• per_page (padrão: 20, máximo: 100)

Resposta inclui:

• total
• total_pages
• page
• per_page

---

 Rate limit

• Limite: 100 requisições por minuto por API Key

Se excedido:

• Retorno HTTP 429
• Header Retry-After indicando quando tentar novamente

---

Tratamento de erros

A API retorna erros padronizados:

{

 "error": "Mensagem descritiva",

 "code": "codigo_erro"

}

Principais códigos HTTP:

• 400 → Parâmetros inválidos
• 401 → API Key inválida ou ausente
• 404 → Recurso não encontrado
• 422 → Regra de negócio (ex: rejeição duplicada)
• 429 → Rate limit excedido
• 500 → Erro interno

---

 Valores nulos

• Campos opcionais sempre aparecem no JSON
• Quando não possuem valor → null
• Listas vazias → [] (nunca null)

Exemplos:

• phone: null → candidato não informou
• resume_url: null → sem currículo
• linkedin_url: null → não informado

---

 Exemplo de fluxo de integração

Um fluxo típico pode ser:

1. Seu ATS busca todas as vagas (GET /jobs)
2. Para cada vaga, busca candidatos (GET /jobs/{job_id}/applications)
3. Recrutador analisa no ATS
4. Ao rejeitar um candidato → chama API (POST /applications/{id}/reject)

Resultado: pipeline sincronizado sem duplicação de trabalho

---

 Benefícios da integração

---

O ATS Integration já está disponível para clientes Standard e Premium.

Gere sua API Key e comece a integrar hoje mesmo para tornar seu processo seletivo mais ágil, automatizado e eficiente.