Aan de slag

Deze handleiding beschrijft stap voor stap hoe u Proctorio integreert in uw leerplatform.

Vereisten

• Een Proctorio API-sleutel (neem contact op met uw accountmanager)
• Een LMS of examenplatform met URL-adresseerbare examenpagina's
• HTTPS-ingeschakelde examen-URL's (vereist voor proctoring)

Integratieproces

De integratie volgt een eenvoudig patroon:

1. Uw platform stuurt een POST-verzoek naar de Proctorio API met de examenconfiguratie
2. Proctorio API retourneert een beveiligde URL
3. Uw platform stuurt de student door naar die URL
4. Proctorio verzorgt de voorafgaande controles, bewaking en opname
5. Het examen eindigt wanneer de student het exam_end URL-patroon bereikt

URL-patroonherkenning

Proctorio gebruikt regex-patronen om de levenscyclus van het examen te begrijpen:

• exam_start — Waar het examen begint (de startpagina)
• exam_take — Pagina's die deel uitmaken van het examen (vragen, navigatie)
• exam_end — Waar het examen is ingediend

Belangrijk: De waarde van launch_url moet overeenkomen met het exam_start-patroon. Alle omleidingen tussen examenpagina's moeten overeenkomen met het exam_take-patroon.

Single-page-applicaties

Voor SPA's waarbij de URL niet verandert tussen examenstaten, gebruik de postMessage API:

// 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"
);

Bij gebruik van postMessage stelt u de corresponderende parameterwaarde in op "post_message_notification".

Snelreferentie exameninstellingen

Instelling	Doel	Afhankelijkheden
record_video	Webcam opnemen	Geen
record_audio	Microfoon opnemen	Geen
record_screen	Volledig bureaublad opnemen	Geen
verify_video	Webcam valideren	record_video
verify_id	Identiteitsverificatie	record_video, verify_video (voor niveau 2)
full_screen	Volledig scherm forceren	close_tabs, one_screen, tabs: 1
live_proctor	Realtime bewaking	record_video, verify_video

Foutafhandeling

Alle API-fouten retourneren gestructureerde JSON. Zie de handleiding Foutafhandeling voor meer informatie.