一次面接

候補者のメールアドレス、質問、ジョブメタデータ、およびコールバックURLを送信します。Curriculoは候補者にインタビューへのリンクを含むメールを送信し、記録をホストし、各回答を書き起こし、回答が入るたびにそれをあなたの callback_url にPOSTします。送信に失敗したアドレスは、他のアドレスの送信をキャンセルしません。

価格: $0.02 の実際に送信された招待状ごとに請求されます。失敗した招待状は課金されません。

[！NOTE] これらのエンドポイントはまだOpenAPI仕様またはSwagger UIに含まれておりません。Consoleキーを使用して直接呼び出してください。

リクエスト

application/json

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= と生の本文の小文字16進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 は、採用担当者が回答の記録と書き起こしを一緒に閲覧できるATSの結果ページ用のプライベートCurriculoメディアリンクです。

[！NOTE] コールバックURLは、候補者ページでも採用担当者ダッシュボードでもない、あなたのバックエンドURLです。Curriculoは署名付きのマシンリーダブルな結果をそこに送信します。あなたの製品が、採用担当者が結果をどのように見るかを決定します。

スクリーニングを受ける

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

いつでもスクリーニングの結果を読み取ることができます。古い録音リンクが期限切れになっている場合、最新のメディアURLを受け取るために、再度スクリーニングを要求してください。

データの取り扱い

スクリーニング面接では、招待、候補者の回答、録音を保存するため、あなたのATSは完了した録音と書き起こしを取得できます。 のデータの取り扱いを参照してください.