Curriculo ATS REST API

集成

对您的招聘数据进行全面的程序化访问。创建职位、获取候选人评分、同步管道并构建自定义工作流程。适用于Pro计划（每月50美元）。

CurriculoATS REST API提供对您的招聘数据的全面程序化访问，使团队能够创建职位、检索候选人评分、管理管道阶段以及与HRIS、薪资和报告工具构建自定义集成。API使用标准的REST约定，返回JSON响应，采用API密钥身份验证，并提供实时更新的webhook事件。Pro计划每月50美元，在限速范围内没有按请求收费。

API 功能

职位和候选人的CRUD

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

评分和管道数据

检索每位候选人的影响评分（0-100）和维度细分。查询管道阶段，跟踪候选人进度，并提取聚合的招聘指标，用于自定义仪表板和报告。

Webhook事件

订阅实时Webhook事件：收到新申请、候选人评分、阶段变化、发送报价、候选人被聘用。每个Webhook将完整事件上下文的JSON负载发送到您的终端。

批量导出

批量导出候选人数据、评分结果和管道快照。提取某个职位的所有候选人、所有职位的所有评分或合规性和报告要求的完整管道历史。

使用案例

与HRIS和薪资同步

当候选人在CurriculoATS中被标记为已聘用时，自动将其资料推送到您的HRIS（BambooHR、Rippling等）或薪资系统（Gusto、ADP）。消除招聘与入职之间的手动数据输入。

自定义分析仪表板

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

自动职位发布

从您的内部工具或职业网站CMS中以编程方式在CurriculoATS中创建职位列表。当您的团队打开新职位时，API会自动创建该职位，设置评分标准并激活管道。

候选人数据丰富

使用Webhook在新候选人申请时触发丰富工作流。从Clearbit、LinkedIn或您自己的数据库中获取额外数据，然后通过API将丰富的资料写回CurriculoATS。

技术

身份验证与速率限制

API密钥身份验证

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

速率限制

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

文档

完整的API文档在CurriculoATS开发者门户上提供给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
}
}'