Evaluar a un candidato
https://api.curriculo.me/public/evaluate/
resume_pdfsyresume_pdfaceptan DOCX así como PDF, a pesar de los nombres de campo. Envía cada CV como su propia parteresume_pdfs.
Obtiene una puntuación de CV en función de un puesto de trabajo y, para cada CV, una puntuación de idoneidad con razonamiento por escrito, las habilidades del candidato, las lagunas y los puntos de resumen. Cada CV se evalúa individualmente en relación con el mismo trabajo.
Precio: $ 0.01 por CV: un CV cuesta $ 0.01, diez cuesta $ 0.10. Los CV que fallan no se cobran.
¿Cómo evalúa Curriculo a un candidato?
POST /evaluate/ Ponga un puntaje en cada CV que envíe contra un puesto de trabajo y devuelve un puntaje de idoneidad con razonamiento escrito, las habilidades del candidato, las brechas y los puntos de resumen cortos. Envíe el trabajo como texto pegado, una descripción del trabajo PDF o DOCX, o un job_id que haya registrado antes. Cada CV se evaluará por sí solo.
Solicitud
multipart/form-data
| El campo | Tipo | Notas |
|---|---|---|
resume_pdfs | archivo[] | Un a 10 CV, PDF o DOCX (a pesar del nombre del campo), 10 MB cada uno. Cada CV se evalúa en comparación con el mismo trabajo. |
resume_pdf | archivo | Un alias de documento único. PDF o DOCX. |
job_details | cuerdas | El trabajo como texto plano pegado de su página de carreras, o un objeto JSON si tiene requisitos estructurados. |
job_file | archivo | La descripción del trabajo como PDF o DOCX. |
job_id | cuerdas | Un trabajo registrado anteriormente a través de POST /jobs/, enviado en lugar de repetir la descripción en un backlog. |
language | cuerdas | Código ISO 639-1 para la prosa dirigida al candidato. Vacío significa languagedel trabajo registrado, en inglés. |
Proporciona el trabajo exactamente de una manera:
job_details,job_fileojob_id. Enviar la descripción en línea siempre funciona. Registrar un trabajo primero es una optimización, nunca un paso requerido.
Ejemplos
Descripción del trabajo en línea:
curl -X POST https://api.curriculo.me/public/evaluate/ \
-H 'Authorization: Bearer key_abc123_yoursecret' \
-F 'resume_pdf=@candidate.docx' \
-F 'job_details=Senior backend engineer, Python and FastAPI, Seoul'Una lista de currículos de un puesto de trabajo 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'Respuesta
Una CV devuelve el objeto de evaluación de CV. Varios CV devuelven una matriz results , una entrada por CV, en orden de entrada. Véase Batching.
El tiempo
Hasta 60 segundos por evaluación. Mantenga el tiempo de espera de su cliente por encima de cinco minutos. Para un backlog, utilice POST /evaluate/async con hasta 25 enlaces por tarea.
Errores
| Estatus | Causa típica |
|---|---|
400 | CV ilegible, o ningún CV o ningún trabajo enviado. |
404 | Desconocido job_id, o uno registrado por una cuenta diferente. Regístrese el trabajo de nuevo. |
413 | Un CV superior a 10 MB, superior a 10 CV, o un organismo de solicitud superior a 12 MB. |
504 | El procesamiento superó los 300 segundos. Envía menos CV por solicitud. |
¿Es tu primera vez con la API de Curriculo? Empieza por el Inicio rápido.
Actualizado