Curriculo ATS REST API

集成

完全程序化访问您的招聘数据。创建职位、获取候选人得分、同步流程，并构建自定义工作流程。可在 Pro 计划（$50/月）中使用。

Curriculo ATS REST API 提供对您的招聘数据的完全程序化访问，使团队能够创建职位、检索候选人得分、管理流程阶段，并与 HRIS、薪资和报告工具构建自定义集成。该 API 使用标准 REST 约定，具有 JSON 响应、API 密钥认证和 webhook 事件以获取实时更新。可在每月 $50 的 Pro 计划中使用，且在速率限制内没有每个请求的费用。

API 功能

职位和候选人的 CRUD

以编程方式创建、读取、更新和删除职位和候选人。从内部工具发布新的职位列表、批量更新候选人阶段，并与外部系统同步候选人档案。对所有核心资源进行完整的 CRUD 操作。

得分和流程数据

检索每位候选人的影响得分（0–100）和维度分解。查询流程阶段、跟踪候选人进展，并获取自定义仪表板和报告的汇总招聘指标。

Webhook 事件

订阅实时 webhook 事件：收到新申请、候选人评分、阶段变更、发送报价、候选人被雇佣。每个 webhook 将完整事件上下文的 JSON 负载传递到您的端点。

批量导出

批量导出候选人数据、评分结果和流程快照。获取某个角色的所有候选人、所有角色的所有得分，或出于合规和报告要求而获取完整的流程历史。

使用 案例

与 HRIS 和薪资同步

当候选人在 Curriculo ATS 中标记为被雇佣时，自动将其档案推送到您的 HRIS（BambooHR、Rippling 等）或薪资系统（Gusto、ADP）。消除招聘和 onboarding 之间的手动数据输入。

自定义分析仪表板

通过 API 提取招聘指标，并在您选择的 BI 工具（Looker、Metabase 或 Google Sheets）中构建自定义仪表板。跟踪招聘时间、来源质量、得分分布和漏斗转化率。

自动发布职位

从您的内部工具或职业网站 CMS 中以编程方式在 Curriculo ATS 中创建职位列表。当您的团队开启新角色时，API 自动创建职位、设置评分标准并激活流程。

候选人数据丰富

使用 webhook 在新候选人申请时触发丰富工作流程。从 Clearbit、LinkedIn 或您自己的数据库中提取额外数据，然后通过 API 将丰富后的档案写回 Curriculo ATS。

技术

认证与 速率限制

API 密钥认证

从 Curriculo ATS 仪表板的设置 > API 下生成一个 API 密钥。将密钥包含在每个请求的 Authorization 头中。密钥可以随时轮换，而不会中断活动集成。

速率限制

标准速率限制为每个 API 密钥每分钟 100 个请求。当超过限制时，API 返回 429 状态代码，并附带 Retry-After 头，指示何时重试。在企业计划上可提供更高的限制。

文档

完整的 API 文档可在 Curriculo ATS 开发者门户中提供给 Pro 计划订阅者。包括交互式 API 探索器、cURL、Python、Node.js 和 Ruby 的代码示例，以及 webhook 测试工具。

代码 示例

通过单个 API 调用创建新的职位列表。

# 创建新的职位列表
curl -X POSThttps://api.curriculo.me/v1/jobs \
-H"Authorization: Bearer YOUR_API_KEY" \
-H"Content-Type: application/json" \
-d'{
"title": "高级后端工程师",
"department": "工程",
"location": "远程",
"employment_type": "全职",
"description": "构建和扩展我们的 API 基础设施...",
"scoring_criteria": {
"role_fit_weight": 40,
"outcomes_weight": 35,
"context_weight": 25
}
}'