初步面试

POSThttps://api.curriculo.me/public/screening-interview

GEThttps://api.curriculo.me/public/screening-interview/{screening_id}

On this page

请求
响应
回调
获取筛选
数据处理

发送候选人电子邮件地址、问题、职位元数据和回调 URL。Curriculo 向每个候选人发送面试链接、托管录制、转录每个答案，并将每个答案以POST方式发送到您的 callback_url ，答案随时到达。失败的地址不会取消其他地址.

价格： 每实际发送的邀请 $0.02。失败的邀请不收费.

这些端点尚未在 OpenAPI 规范或 Swagger UI 中。请使用控制台密钥直接调用它们.

请求

application/json

字段	必需	备注
`candidate_emails`	是	1至50个普通电子邮件地址。
`questions`	是	1至10个问题。候选人按顺序回答这些问题。
`callback_url`	是	`https` URL在您的服务器上。我们POST每个答案在此处。无用户名、密码或 `#` 片段在URL中。
`job_title`	否	显示在邀请中。默认为“筛选”。
`company`	否	显示在邀请中。默认为"招聘团队"。

curl -X POST https://api.curriculo.me/public/screening-interview \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -H 'Content-Type: application/json' \
  -d '{
    "candidate_emails": ["[email protected]"],
    "questions": ["Tell us about a system you shipped."],
    "callback_url": "https://example.com/screening",
    "job_title": "Backend engineer"
  }'

响应

该电话回答 202 以 screening_id的形式，显示一次 callback_secret ， sent_count，以及一个 invites 列表。每个邀请都是 sent 或 failed。存储 callback_secret.

回调

每个答案都是一个签名的 POST 发送到您的服务器。 X-Curriculo-Signature 是 sha256= 加上原始正文的十六进制 HMAC-SHA256，以 callback_secret 从 202 中获取（按原样使用）。验证它与后台任务回调完全相同.

{
  "screening_id": "...",
  "email": "[email protected]",
  "question": "Tell us about a system you shipped.",
  "question_index": 0,
  "transcript": "I shipped the billing service.",
  "recording_url": "https://api.curriculo.me/public/screening-interview/.../recording",
  "media_kind": "video",
  "duration_seconds": 142,
  "completed": false
}

question_index 从 0 开始。
completed 保持 false 直到该候选人对每个问题都有最终答案。
recording_url 是一个私有的 Curriculo 媒体链接，用于您的 ATS 结果页面，招聘人员可以在转录旁边观看答案。

回调 URL 是您的后端 URL，而不是候选人页面，也不是招聘人员仪表盘。Curriculo 发送签名的、机器可读的结果到那里；您的产品决定招聘人员如何查看它们。

获取筛选

curl https://api.curriculo.me/public/screening-interview/<screening_id> \
  -H 'Authorization: Bearer key_abc123_yoursecret'

可以随时查看筛选结果。如果旧的录音链接已过期，可以重新请求筛选以获取新的媒体URL。

数据处理

筛选面试保留邀请、候选人答案和录音，以便您的ATS可以检索已完成的录音和转录。请参阅数据处理.

Updated 12 October 2026