Avaliar um candidato

POSThttps://api.curriculo.me/public/evaluate/

On this page

Solicitação
Exemplos
Resposta
Temporização
Erros

Estadoless. Avalia currículos contra uma vaga e retorna, para cada CV, uma pontuação de adequação com justificativa escrita, habilidades correspondentes, lacunas e pontos resumidos. Cada CV é avaliado individualmente contra a mesma vaga.

Preço: $0.01 por solicitação, independentemente de conter um CV ou dez.

Solicitação

multipart/form-data

Campo	Tipo	Notas
`resume_pdfs`	arquivo[]	De um a 10 currículos, PDF ou DOCX (apesar do nome do campo), 10 MB cada. Todo CV é avaliado contra a mesma vaga.
`resume_pdf`	arquivo	Alias de documento único. PDF ou DOCX.
`job_details`	cadeia de caracteres	O emprego como texto simples colado da página de carreiras, ou um objeto JSON se você tiver requisitos estruturados.
`job_file`	arquivo	A descrição do emprego como um PDF ou DOCX.
`job_id`	cadeia de caracteres	Um emprego registrado anteriormente por meio de `POST /jobs/`, enviado em vez de repetir a descrição em uma fila de espera.
`language`	cadeia de caracteres	Código 639-1 ISO para a prosa voltada ao candidato. Vazio significa Inglês.

Fornecer o emprego de exatamente uma maneira: job_details,job_file ou job_id. Enviar a descrição inline sempre funciona. Registrar um emprego primeiro é uma otimização, nunca um passo obrigatório.

Exemplos

Descrição do emprego inline:

curl -X POST https://api.curriculo.me/public/evaluate/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -F '[email protected]' \
  -F 'job_details=Senior backend engineer, Python and FastAPI, Seoul'

Uma lista de currículos contra um emprego registrado:

curl -X POST https://api.curriculo.me/public/evaluate/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -F 'resume_pdfs=@candidate_a.pdf' \
  -F 'resume_pdfs=@candidate_b.pdf' \
  -F 'job_id=job_abc123'

Resposta

Um CV retorna o objeto de avaliação de CV. Vários currículos retornam um array results , uma entrada por CV, na ordem de entrada. Consulte Lote.

Temporização

30 a 60 segundos por avaliação. Mantenha o tempo limite do cliente acima de cinco minutos. Para uma fila, use POST /evaluate/async com até 25 links por tarefa.

Erros

Status	Causa típica
`400`	CV ilegível ou com formato inválido `job_details`.
`404`	`job_id`desconhecido, ou registrado por uma conta diferente. Registre o trabalho novamente.
`413`	Um CV superior a 10 MB, mais de 10 currículos, ou um corpo de solicitação superior a 12 MB.
`422`	Um campo obrigatório está faltando ou mal nomeado.
`504`	O processamento excedeu 300 segundos. Envie menos currículos por solicitação.

Updated 12 October 2026