Entrevista de selección

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

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

On this page

Solicitud
Respuesta
Devoluciones de llamada
Obtenga una evaluación
Manipulación de datos

Enviar direcciones de correo electrónico de los candidatos, preguntas, metadatos del trabajo y una devolución de llamada URL. Curriculo envía a cada candidato un enlace a la entrevista, hospeda la grabación, transcribe cada respuesta y envía cada respuesta a su callback_url a medida que llega. Una dirección fallida no cancela las demás.

Precio: $0.02 por invitación enviada realmente. Las invitaciones fallidas no se cobran.

Estos puntos de conexión no están aún en la especificación OpenAPI ni en Swagger UI. Llámelos directamente con su clave de consola.

Solicitud

application/json

Campo	Requerido	Notas
`candidate_emails`	Sí	De 1 a 50 direcciones de correo electrónico simples.
`questions`	Sí	De 1 a 10 preguntas. El candidato responde a cada una en orden.
`callback_url`	Sí	`https` URL en su servidor. Registramos POST cada respuesta aquí. No incluye nombre de usuario, contraseña ni fragmento de `#` en la URL.
`job_title`	No	Se muestra en la invitación. El valor predeterminado es "Evalución inicial".
`company`	No	Se muestra en la invitación. El valor predeterminado es "el equipo de contratación".

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

Respuesta

La llamada responde con 202 y un screening_id, un callback_secret mostrado una vez, sent_count, y una lista invites . Cada invitación es sent o failed. Almacene callback_secret.

Devoluciones de llamada

Cada respuesta es una firma POST enviada a su servidor. X-Curriculo-Signature es sha256= más el hexadecimal en minúsculas HMAC-SHA256 del cuerpo sin procesar, con clave del callback_secret desde el 202 (utilizado tal como está). Verifíquelo exactamente como para las devoluciones de llamada de tareas en segundo plano .

{
  "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 comienza en 0
completed permanece false hasta que el candidato tenga una respuesta final para cada pregunta
El recording_url es un enlace de medios privado Curriculo, destinado a la página de resultados de su ATS, donde los reclutadores pueden ver la respuesta junto a la transcripción

La devolución de llamada URL es el backend URL de su producto, no una página de candidatos ni un panel de control de reclutadores. Curriculo envía resultados firmados y legibles por máquina allí; su producto decide cómo los reclutadores los ven

Obtenga una evaluación

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

Lea los resultados de una evaluación en cualquier momento. Si un enlace de grabación antiguo ha caducado, solicite la evaluación nuevamente para recibir un enlace de medios fresco URL

Manipulación de datos

Las entrevistas de selección conservan las invitaciones, las respuestas de los candidatos y las grabaciones para que su ATS pueda recuperar las grabaciones y transcripciones completadas. Consulte Manejo de datos.

Updated 12 October 2026