Gestion des erreurs

L'API Proctorio utilise des codes de statut HTTP standard et renvoie des réponses d'erreur structurées.

Codes de statut HTTP

Code	Signification
200	Succès — la requête a été complétée et l'URL a été générée
400	Requête incorrecte — la validation a échoué sur un ou plusieurs champs
401	Non autorisé — clé API invalide ou manquante
429	Trop de requêtes — limite de débit dépassée
500	Erreur serveur — erreur interne, réessayez avec un délai exponentiel

Format de réponse d'erreur

Les erreurs de validation (400) renvoient un tableau d'objets d'erreur :

[
  {
    "memberNames": ["launch_url"],
    "errorMessage": "The launch_url field is required."
  },
  {
    "memberNames": ["exam_settings"],
    "errorMessage": "exam_settings is required."
  }
]

Codes d'erreur 401

Code	Description
2154	Compte non actif — contactez votre gestionnaire de compte
2155	Région incorrecte — utilisez le bon point de terminaison régional
2655	Clé API invalide — vérifiez la valeur de votre clé

Bonnes pratiques

• Validez toujours le contenu de votre requête avant de l'envoyer
• Implémentez une logique de nouvelle tentative avec un délai exponentiel pour les erreurs 5xx
• Enregistrez le corps complet de la réponse d'erreur pour le débogage
• N'exposez jamais votre clé API dans du code côté client