Fehlerbehandlung

Die Proctorio-API verwendet standardmäßige HTTP-Statuscodes und gibt strukturierte Fehlerantworten zurück.

HTTP-Statuscodes

Code	Bedeutung
200	Erfolg — Anfrage abgeschlossen und URL wurde generiert
400	Ungültige Anfrage — Validierung für ein oder mehrere Felder fehlgeschlagen
401	Nicht autorisiert — ungültiger oder fehlender API-Schlüssel
429	Zu viele Anfragen — Ratenlimit überschritten
500	Serverfehler — interner Fehler, mit exponentiellem Backoff erneut versuchen

Format der Fehlerantwort

Validierungsfehler (400) geben ein Array von Fehlerobjekten zurück:

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

401-Fehlercodes

Code	Beschreibung
2154	Konto nicht aktiv — wenden Sie sich an Ihren Account-Manager
2155	Falsche Region — verwenden Sie den richtigen regionalen Endpunkt
2655	Ungültiger API-Schlüssel — überprüfen Sie Ihren Schlüsselwert

Bewährte Vorgehensweisen

• Validieren Sie Ihre Anfragenutzlast immer vor dem Senden
• Implementieren Sie Wiederholungslogik mit exponentiellem Backoff für 5xx-Fehler
• Protokollieren Sie den vollständigen Fehlerantworttext zur Fehlerbehebung
• Geben Sie Ihren API-Schlüssel niemals in clientseitigem Code preis