Premiers pas

Ce guide explique comment intégrer Proctorio dans votre plateforme d'apprentissage depuis le début.

Prérequis

• Une clé API Proctorio (contactez votre gestionnaire de compte)
• Un LMS ou une plateforme d'examen avec des pages d'examen accessibles par URL
• Des URL d'examen compatibles HTTPS (obligatoire pour la surveillance)

Flux d'intégration

L'intégration suit un schéma simple :

1. Votre plateforme envoie une requête POST à l'API Proctorio avec la configuration de l'examen
2. API Proctorio renvoie une URL sécurisée
3. Votre plateforme redirige l'étudiant vers cette URL
4. Proctorio gère les vérifications préalables, la surveillance et l'enregistrement
5. L'examen se termine lorsque l'étudiant atteint le modèle d'URL exam_end

Correspondance de modèles d'URL

Proctorio utilise des modèles regex pour comprendre le cycle de vie de l'examen :

• exam_start — Où l'examen commence (la page de lancement)
• exam_take — Pages faisant partie de l'examen (questions, navigation)
• exam_end — Où l'examen a été soumis

Important : La valeur de launch_url doit correspondre au modèle exam_start. Toutes les redirections entre les pages d'examen doivent correspondre au modèle exam_take.

Applications monopage

Pour les SPA où l'URL ne change pas entre les états de l'examen, utilisez l'API 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"
);

Lors de l'utilisation de postMessage, définissez la valeur du paramètre correspondant sur "post_message_notification".

Référence rapide des paramètres d'examen

Paramètre	Objectif	Dépendances
record_video	Enregistrer la webcam	Aucune
record_audio	Enregistrer le microphone	Aucune
record_screen	Enregistrer le bureau complet	Aucune
verify_video	Valider la webcam	record_video
verify_id	Vérification d'identité	record_video, verify_video (pour le niveau 2)
full_screen	Forcer le plein écran	close_tabs, one_screen, tabs: 1
live_proctor	Surveillance en temps réel	record_video, verify_video

Gestion des erreurs

Toutes les erreurs de l'API renvoient du JSON structuré. Consultez le guide de Gestion des erreurs pour plus de détails.