Erste Schritte

Diese Anleitung beschreibt Schritt für Schritt, wie Sie Proctorio in Ihre Lernplattform integrieren.

Voraussetzungen

• Ein Proctorio API-Schlüssel (kontaktieren Sie Ihren Account-Manager)
• Ein LMS oder eine Prüfungsplattform mit URL-adressierbaren Prüfungsseiten
• HTTPS-fähige Prüfungs-URLs (erforderlich für die Prüfungsüberwachung)

Integrationsablauf

Die Integration folgt einem einfachen Muster:

1. Ihre Plattform sendet eine POST-Anfrage an die Proctorio API mit der Prüfungskonfiguration
2. Proctorio API gibt eine sichere URL zurück
3. Ihre Plattform leitet den Studenten zu dieser URL weiter
4. Proctorio übernimmt Vorabprüfungen, Überwachung und Aufzeichnung
5. Die Prüfung endet wenn der Student das exam_end-URL-Muster erreicht

URL-Musterabgleich

Proctorio verwendet Regex-Muster, um den Lebenszyklus der Prüfung zu verstehen:

• exam_start — Wo die Prüfung beginnt (die Startseite)
• exam_take — Seiten, die Teil der Prüfung sind (Fragen, Navigation)
• exam_end — Wo die Prüfung abgegeben wurde

Wichtig: Der Wert von launch_url muss mit dem exam_start-Muster übereinstimmen. Alle Weiterleitungen zwischen Prüfungsseiten müssen mit dem exam_take-Muster übereinstimmen.

Single-Page-Anwendungen

Für SPAs, bei denen sich die URL zwischen Prüfungszuständen nicht ändert, verwenden Sie die 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"
);

Bei Verwendung von postMessage setzen Sie den entsprechenden Parameterwert auf "post_message_notification".

Kurzreferenz für Prüfungseinstellungen

Einstellung	Zweck	Abhängigkeiten
record_video	Webcam aufzeichnen	Keine
record_audio	Mikrofon aufzeichnen	Keine
record_screen	Gesamten Desktop aufzeichnen	Keine
verify_video	Webcam validieren	record_video
verify_id	Identitätsüberprüfung	record_video, verify_video (für Stufe 2)
full_screen	Vollbild erzwingen	close_tabs, one_screen, tabs: 1
live_proctor	Echtzeitüberwachung	record_video, verify_video

Fehlerbehandlung

Alle API-Fehler geben strukturiertes JSON zurück. Weitere Informationen finden Sie in der Anleitung zur Fehlerbehandlung.