API da Entrevistadora WallJobs

Integre entrevistas em vídeo com análise por IA ao seu ATS: crie a vaga, convide candidatos, receba webhooks e busque notas, resumo e ranking.

Base URL

https://video-interview.walljobs.ai/api/v1

Fluxo típico

1. POST /interviews — cria a vaga com as perguntas
2. POST /interviews/:id/candidates — convida candidatos e recebe o interview_url de cada um
3. Webhook interview.completed — candidato terminou de gravar
4. Webhook analysis.completed — análise da IA pronta
5. GET /interviews/:id/candidates/:inviteId — resultado completo (nota, resumo, transcrições)

Exemplo rápido

curl -X POST https://video-interview.walljobs.ai/api/v1/interviews \
  -H "X-API-Key: vi_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Desenvolvedor Full Stack",
    "processingMode": "PREMIUM",
    "questions": [
      { "text": "Fale sobre sua experiência com React", "answer_time_sec": 120 }
    ]
  }'

Convenções

• Respostas de sucesso vêm em { "data": ... }; listagens trazem também pagination.
• Erros vêm como { "error": "mensagem" } com o status HTTP correspondente (400, 401, 403, 404, 429). Valores fora do formato documentado (JSON malformado, status inexistente) podem resultar em 500; page/limit inválidos usam o padrão.
• Datas em ISO 8601 (UTC). Campos ausentes vêm como null.
• Os dados da vaga usam camelCase (processingMode, jobTitle); os de candidatos e resultados usam snake_case (invite_id, overall_score).