Interview de dépistage

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

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

On this page

Une demande
Réponse
Retour d'appels
Faites une projection .
Traitement des données

Envoyez les adresses électroniques des candidats, les questions, les métadonnées de l'emploi et un appel-retour URL. Curriculo envoie à chaque candidat un lien vers l'entrevue, organise l'enregistrement, transcrit chaque réponse et publie chaque réponse à votre callback_url au fur et à mesure de son entrée. Une adresse ratée n'annule pas les autres.

Prix: $ 0.02 par invitation réellement envoyée. Les invitations ratées ne sont pas facturées.

Ces terminaux ne sont pas encore dans la spécification OpenAPI ou Swagger UI. Appelez-les directement avec votre clé de console.

Une demande

application/json

champs	Règlement	Remarques
`candidate_emails`	Oui, c'est vrai	1 à 50 adresses électroniques simples.
`questions`	Oui, c'est vrai	1 à 10 questions. Le candidat répond à l'ordre.
`callback_url`	Oui, c'est vrai	`https` URL sur votre serveur. Nous POST chaque réponse ici. Aucun nom d'utilisateur, mot de passe ou fragment `#` dans le URL.
`job_title`	Je ne veux pas.	Il est dans l'invitation. Par défaut, "Screening".
`company`	Je ne veux pas.	Il est dans l'invitation. Par défaut, "l'équipe d'embauche".

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"
  }'

Réponse

L'appel répond à 202 avec un screening_id, un callback_secret montré une fois, sent_count, et une liste invites . Chaque invitation est sent ou failed. Réservez le callback_secret.

Retour d'appels

Chaque réponse est un POST signé à votre serveur. X-Curriculo-Signature est sha256= plus le hexagone minuscule HMAC-SHA256 du corps brut, taillé avec le callback_secret du 202 (utilisé tel qu'il est). Vérifiez-le exactement comme pour les rappels de tâches d'arrière-plan .

{
  "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 commence à 0.
completed reste false jusqu'à ce que ce candidat ait une réponse finale à chaque question.
Le recording_url est un lien médiatique privé Curriculo, destiné à votre page de résultats ATS, où les recruteurs peuvent regarder la réponse à côté de la transcription.

L'appel URL est votre backend URL, pas une page de candidat et pas un tableau de bord de recrutement. Curriculo y envoie des résultats signés et lisibles par machine; votre produit décide de la façon dont les recruteurs les voient.

Faites une projection .

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

Lisez les résultats d'un dépistage à tout moment. Si un ancien lien d'enregistrement a expiré, demandez à nouveau le dépistage pour recevoir un nouveau média URL.

Traitement des données

Le dépistage des interviews garde les invitations, les réponses des candidats et les enregistrements afin que votre ATS puisse récupérer les enregistrements et les transcriptions terminés. Voir Traitement des données.

Updated 12 October 2026