跳到内容

Curriculo 文档

在 Curriculo 上构建招聘工作流

Curriculo API 将原始招聘材料(简历、职位要求、面试录音)转化为结构化、可供决策的数据。一个 REST API,来自开发者控制台的一个承载密钥,无需 ATS 登录。

5美元免费积分,一把钥匙,无需ATS登录

获取 API 密钥快速入门

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 产品内部运行的简历、评估、语言和面试引擎提供编程访问。

你想做什么?

拨打你的第一个电话

  1. 创建账户。 在 控制台中登录。curriculo.me。您的账户在首次登录时即被分配,并添加了一次性 $5.00 免费积分。
  2. 创建 API 密钥。 在控制台中,打开 API 密钥 并选择 创建 API 密钥。密钥看起来像 key_<id>_<secret> 并且只显示一次。它以后无法恢复,因此请将其存储在安全的地方。
  3. 调用接口。 使用您的密钥运行本页顶部的请求。语言检测每次请求费用为 $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 参考中.

核心概念

错误格式、状态代码、请求 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的免费信用额度,因此您可以使用自己的文档在生产环境中进行测试。

标题价值必需
AuthorizationBearer key_<id>_<secret>,您的控制台 API 密钥是的
Content-Typeapplication/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 版本头,路径中也没有版本信息,并且新增的变更(新的可选字段、新的操作)在不破坏现有调用的情况下发布。

接下来是什么?

  • 解析您的第一个简历: 快速入门,账户,密钥和首次调用分为三个步骤。
  • 对职位进行评分: 评估候选人.
  • 同时发送多个文档: 批处理,列表的工作原理,每个端点的上限,以及每个项目的错误。
  • 处理积压任务或长时间录音: 后台处理与回调,长时间工作且不保持连接打开。
  • 计划容量: 速率限制,每个密钥和每个 IP 上限,共享容量以及请求超时。
  • 生成类型化客户端: 客户端 SDK.
  • 预算工作: 定价和计费,每项操作的价格,免费额度和充值。
  • 将 AI 添加到您自己的 ATS: 对于 ATS 构建者,哪个 Curriculo API 适合您的 ATS 的哪个步骤,并附上一个集成示例。

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,轮询任务或接收签名回调。

此页面对您有帮助吗?

更新于