Curriculo 文档
在 Curriculo 上构建招聘工作流
Curriculo API 将原始招聘材料(简历、职位要求、面试录音)转化为结构化、可供决策的数据。一个 REST API,来自开发者控制台的一个承载密钥,无需 ATS 登录。
5美元免费积分,一把钥匙,无需ATS登录
Base URL https://api.curriculo.me/public
curl -X POST https://api.curriculo.me/public/parse/ \
-H 'Authorization: Bearer key_abc123_yoursecret' \
-F 'files=@/path/to/candidate.pdf'从这里开始.
将 Curriculo 用作您自己的 ATS、招聘平台或招聘工作流的 AI 层。您的产品包括候选人、职位、状态以及招聘人员 UI。Curriculo API 负责语言、评估、采访及媒体工作。它是 API 的 RESTful 版本,为 Curriculo 产品内部运行的简历、评估、语言和面试引擎提供编程访问。
你想做什么?
- API构建到我的产品中解析简历,根据职位对候选人进行评分,并通过自有代码翻译和总结面试内容。开发者控制台的其中一个承载密钥。
- MCP在 Claude、ChatGPT 或 Cursor 中使用它负责 Claude、ChatGPT、Cursor 及其他客户的招聘流程。Curriculo ATS的一部分,拥有自己的签到功能。
- 电子邮件代理自动化我的招聘收件箱连接您的招聘邮箱,发送给职位申请地址的简历会自动评分,发送和日历安排也将实现自动化。
拨打你的第一个电话
- 创建账户。 在 控制台中登录。curriculo.me。您的账户在首次登录时即被分配,并添加了一次性 $5.00 免费积分。
- 创建 API 密钥。 在控制台中,打开 API 密钥 并选择 创建 API 密钥。密钥看起来像
key_<id>_<secret>并且只显示一次。它以后无法恢复,因此请将其存储在安全的地方。 - 调用接口。 使用您的密钥运行本页顶部的请求。语言检测每次请求费用为 $0.001,响应时间不到一秒。
Quickstart 逐步演示相同步骤,然后解析简历。
简历解析每份文件最多可能需要90秒。将 HTTP 客户端的超时时间设置为超过五分钟,因为三十秒的超时会导致本应成功的呼叫被放弃。
在编写代码之前先进行测试。同步操作可从控制台的文档页面运行:粘贴您的密钥,附上真实简历,并读取响应。
能力
| 能力 | 操作 | 它的作用 |
|---|---|---|
| 解析简历 | POST /parse/ | PDF 或 DOCX 输入,结构化 JSON 输出:联系方式、角色、日期、技能。每次请求最多10份文件。 |
| 评估候选人 | POST /evaluate/ | 对职位进行评分:匹配分析、差距、适用性。以粘贴文本、JD 文档或已注册的形式发送工作。 job_id. |
| 注册工作 | POST /jobs/ | 可选且免费。存储一次职位描述,并在简历积压中重复使用返回的 job_id 。 |
| 翻译 | POST /translate/ | 翻译一个字符串,最多200个字符串,或整个PDF和DOCX文档,到202种语言中的任何一种。 |
| 检测语言 | POST /detect-language/ | 文本代码(ISO 639-1,或在没有时 FLORES-200),用于一个文本或最多200个批处理文本。 |
| 总结采访 | POST /summary/ | 一份转录稿、转录文档或录音;包含亮点、红旗警示、技能以及录用建议。 |
| 转录 | POST /transcribe/ | 输入录音,输出文本,无摘要。 |
| 提示简历 | POST /prompt/ | 生成、编辑、翻译或就绑定至您凭证的简历提出疑问,使用通俗易懂的语言。有状态的 |
| 筛选面试 | POST /screening-interview | 邀请候选人参加托管的录制面试,并在您的服务器上接收每位候选人的签名答案、转录文本和录音链接。 |
长时间运行的任务(如简历积压处理、长达一小时的录音)在后台运行:参见 后台处理与回调。每个操作的每个请求字段都在 API 参考中.
核心概念
- 认证将您的控制台密钥作为承载令牌发送。一个密钥授权所有操作,立即生效。不存在按端点设置的凭据,也不存在作用域,无需启用任何功能。
- 异步与回调解析、评估、摘要、转录和翻译也在后台运行:POST /{op}/async 立即返回 202 状态码及 task_id。轮询任务或接收已签名的回调。
- 批处理没有单独的批处理端点:列表即为批处理。每次请求最多可解析和评估10份文档,最多可翻译和检测语言200份文本。
- 限制和错误每个密钥每分钟最多600个请求,每个IP地址每分钟最多2,000个请求,请求超时时间为300秒。繁重的工作在共享的服务容量上运行。错误是 JSON,而 HTTP 状态才重要。
错误格式、状态代码、请求 ID 和重试指南位于 错误。数据类型和大小限制适用于 请求和响应.
定价
预付,按请求,从单一余额中扣除。 $0.001 用于检测语言, $0.01 用于解析或评估简历,以及一次性 $5.00 免费积分以开始使用。失败的请求不会收费。 查看每个价格.
招聘团队的集成
Curriculo ATS 是贵团队用于签到的招聘产品,同时还能与贵团队已有的工具相连接。这些是独立于公共 API 的产品,拥有自己的登录方式。
- Curriculo ATS MCP 服务器:处理来自 Claude、ChatGPT、Cursor 及其他客户的招聘流程。
- 邮件代理和:连接您的招聘邮箱,该代理会将发送至职位申请地址的简历邮件自动处理为评分后的申请人,并自动化发送流程及管理日历。
- **通过 MCP**进行松弛:使用带有 MCP 能力助手的 Curriculo ATS 松弛。
账户和基础 URL
| 环境 | 基础 URL | 凭证 |
|---|---|---|
| 生产 | https://api.curriculo.me/public | 控制台按键 key_<id>_<secret> |
每个操作都位于同一个基本的URL下。将您的客户端指向该基本路径并追加操作路径,例如 https://api.curriculo.me/public/parse/。生产环境是唯一发布的环境,新账户开始时有$5.00的免费信用额度,因此您可以使用自己的文档在生产环境中进行测试。
| 标题 | 价值 | 必需 |
|---|---|---|
Authorization | Bearer key_<id>_<secret>,您的控制台 API 密钥 | 是的 |
Content-Type | application/json 或 multipart/form-data,具体取决于操作 | 是的,在带有请求体的请求中 |
console.curriculo.me 是账户的起点和管理中心:登录、API 密钥、使用情况和账单。您的 API 密钥用于招聘工作。它故意无法生成密钥或更改账单信息,因此泄露的密钥永远无法升级为账户控制权。查看 开发控制台.
请求为 JSON 或 multipart/form-data;响应为 JSON,但边缘自身的 413 (超大请求)和 404 (超出 /public/的路径)页面除外。同步操作以斜杠结尾(/parse/)。背景任务路径(/parse/async、/parse/tasks/{task_id})和筛选路径(/screening-interview)已记录,无遗漏。没有 API 版本头,路径中也没有版本信息,并且新增的变更(新的可选字段、新的操作)在不破坏现有调用的情况下发布。
接下来是什么?
FAQ
Curriculo API的基数URL是什么?
https://api.curriculo.me/public. Every operation lives under it, and production is the only published environment.
我该如何进行身份验证?
以Bearer令牌的形式发送开发人员控制台密钥:Authorization: Bearer key_<id>_<secret>.
是否有批量接口?
不。该列表为批处理:在一次请求中发送多个文档或字符串,每个结果将按顺序返回。
长时间工作会有什么影响?
使用异步通道 /{op}/async,轮询任务或接收签名回调。
更新于