评估候选人

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

On this page

请求
示例
响应
时间
错误

无状态。 评估简历与工作岗位的匹配度，返回每个CV的适合度评分、书面理由、匹配技能、差距和摘要要点。每个CV都会单独评估与同一工作岗位的匹配度。

价格： 每次请求 $0.01，无论请求中包含一个CV还是十个。

请求

multipart/form-data

字段	类型	备注
`resume_pdfs`	文件[]	1至10份简历，PDF或DOCX（尽管字段名称不同），每份MB10份。每个CV都根据同一份工作进行评估。
`resume_pdf`	文件	单文档别名。PDF或DOCX。
`job_details`	字符串	从您的职业页面复制的工作内容的纯文本，或如果您拥有结构化要求，则为JSON对象。
`job_file`	文件	工作描述作为PDF或DOCX。
`job_id`	字符串	通过 `POST /jobs/`注册的早期工作，代替在大量简历中重复描述。
`language`	字符串	候选人面向的ISO639-1代码。空表示英语。

提供工作描述的方式有三种： job_details、job_file 或 job_id。内联工作描述总是有效的，先注册工作是一个优化步骤，但不是必需的。

示例

内联工作描述：

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'

针对已注册工作的简历列表：

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'

响应

一个CV返回该CV的评估对象。多个简历返回一个 results 数组，每个CV一个条目，按输入顺序排列。请参阅批处理.

时间

每次评估30至60秒。请将客户端超时设置为五分钟以上。对于积压任务，请使用 POST /evaluate/async ，每个任务最多包含25个链接。

错误

状态	典型原因
`400`	无法读取的 CV 或格式错误 `job_details`.
`404`	未知的 `job_id`，或由其他账户注册的。请重新注册该职位.
`413`	一个 CV 超过 10个 MB，超过 10 份简历，或请求体超过 12 个 MB。
`422`	缺少必填字段或字段名称错误。
`504`	处理时间超过 300秒。请减少每次请求的简历数量。

Updated 12 October 2026