Primeros pasos

Esta guía explica cómo integrar Proctorio en su plataforma de aprendizaje desde cero.

Requisitos previos

• Una clave de API de Proctorio (contacte a su administrador de cuenta)
• Un LMS o plataforma de exámenes con páginas de examen accesibles por URL
• URL de exámenes habilitadas con HTTPS (obligatorio para la supervisión)

Flujo de integración

La integración sigue un patrón sencillo:

1. Su plataforma envía una solicitud POST a la API de Proctorio con la configuración del examen
2. API de Proctorio devuelve una URL segura
3. Su plataforma redirige al estudiante a esa URL
4. Proctorio se encarga de las comprobaciones previas, la supervisión y la grabación
5. El examen finaliza cuando el estudiante llega al patrón de URL exam_end

Coincidencia de patrones de URL

Proctorio utiliza patrones regex para comprender el ciclo de vida del examen:

• exam_start — Donde comienza el examen (la página de inicio)
• exam_take — Páginas que forman parte del examen (preguntas, navegación)
• exam_end — Donde se ha enviado el examen

Importante: El valor de launch_url debe coincidir con el patrón exam_start. Todas las redirecciones entre páginas del examen deben coincidir con el patrón exam_take.

Aplicaciones de página única

Para SPA donde la URL no cambia entre estados del examen, utilice la API de postMessage:

// Transition to exam-taking state
window.top.postMessage(
  ["exam_state_change", "exam_take"],
  "https://getproctorio.com"
);

// Exam completed
window.top.postMessage(
  ["exam_state_change", "exam_end"],
  "https://getproctorio.com"
);

Al utilizar postMessage, establezca el valor del parámetro correspondiente en "post_message_notification".

Referencia rápida de configuración de exámenes

Configuración	Propósito	Dependencias
record_video	Grabar cámara web	Ninguna
record_audio	Grabar micrófono	Ninguna
record_screen	Grabar escritorio completo	Ninguna
verify_video	Validar cámara web	record_video
verify_id	Verificación de identidad	record_video, verify_video (para nivel 2)
full_screen	Forzar pantalla completa	close_tabs, one_screen, tabs: 1
live_proctor	Supervisión en tiempo real	record_video, verify_video

Manejo de errores

Todos los errores de la API devuelven JSON estructurado. Consulte la guía de Manejo de errores para más detalles.