Loteamento
On this page
Não há um endpoint de lote separado. A lista é o lote, e uma solicitação retorna todos os resultados. Envie um item e obtenha a resposta diretamente; envie vários e os resultados são retornados na ordem em que foram enviados, um por item.
Uma lista é faturada como uma solicitação: dez currículos em uma chamada /parse/ custam $0.01. Consulte Preços e faturamento.
Limites por operação
| Operação | Campo de lista | Limite | Alias de item único |
|---|---|---|---|
/parse/ | files | 10 documentos | file |
/evaluate/ | resume_pdfscontra um cargo | 10 documentos | resume_pdf |
/translate/ | textsou files | 200 cadeias de caracteres e 50.000 caracteres, ou 10 documentos | text |
/detect-language/ | texts | 200 textos | text |
/summary/ | JSON matriz de entrevistas, ou repetida media | 10 entrevistas ou arquivos | um objeto único |
/prompt/ | nenhum | uma instrução por chamada (com estado) | nenhum |
/parse/async, /evaluate/async | file_urls, resume_urls | 25 links | nenhum |
Três propriedades para projetar em torno
- A ordem é preservada.
results[i]sempre pertence à entradai. - Falhas são por item. Um documento inválido retorna uma entrada de erro ao lado das entradas bem-sucedidas, e o status HTTP permanece
200. - As respostas em lote estão dentro do orçamento da solicitação. Itens que nunca começaram antes do orçamento de 300 segundos expirar retornam uma entrada
504em vez de afetar toda a solicitação. Reenvie apenas esses.
Reenviar um item com falha é sempre seguro. Não pode criar duplicatas ou registros incompletos.
Filas de espera maiores que uma solicitação
Para uma fila de espera, prefira a faixa assíncrona :POST /parse/async ou POST /evaluate/async aceita até 25 links por tarefa, responde de uma vez e entrega o resultado por callback ou polling.
Trabalhos pesados executam três operações de cada vez em capacidade compartilhada em todo o serviço; além disso, as solicitações são enfileiradas em vez de falhar. A taxa de transferência sustentada é de aproximadamente 2 a 4 CVs por minuto e varia com a carga. Se você precisar de muito mais, informe-nos o volume. Veja Limites de taxa.
Análise de CV leva 40 a 90 segundos por documento. Trate o processamento de CV como um trabalho em segundo plano, não como uma carga de página, e mantenha o tempo limite do cliente acima de cinco minutos.
Avaliando uma fila de espera contra um trabalho
Registre a descrição uma vez (gratuitamente), em seguida, envie listas de currículos contra o job_id que ele retorna. O job_details inline faz o mesmo trabalho, mas registrar mantém um longo histórico de reenvio do mesmo parágrafo com cada solicitação.
# 1. Register the job. Returns a job_id.
curl -X POST https://api.curriculo.me/public/jobs/ \
-H 'Authorization: Bearer key_abc123_yoursecret' \
-H 'Content-Type: application/json' \
-d '{"job_details": "Senior backend engineer, Python and FastAPI, Seoul", "label": "BE-Seoul"}'
# -> {"job_id": "job_abc123", "label": "BE-Seoul"}
# 2. Evaluate a list of CVs against it.
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.docx' \
-F 'job_id=job_abc123'Updated