Foutafhandeling

De Proctorio API gebruikt standaard HTTP-statuscodes en retourneert gestructureerde foutresponsen.

HTTP-statuscodes

Code	Betekenis
200	Succes — verzoek voltooid en URL is gegenereerd
400	Ongeldig verzoek — validatie mislukt voor een of meer velden
401	Niet geautoriseerd — ongeldige of ontbrekende API-sleutel
429	Te veel verzoeken — snelheidslimiet overschreden
500	Serverfout — interne fout, probeer opnieuw met exponentiële vertraging

Indeling van foutrespons

Validatiefouten (400) retourneren een array van foutobjecten:

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

401-foutcodes

Code	Beschrijving
2154	Account niet actief — neem contact op met uw accountmanager
2155	Onjuiste regio — gebruik het juiste regionale endpoint
2655	Ongeldige API-sleutel — controleer uw sleutelwaarde

Beste werkwijzen

• Valideer altijd uw verzoekpayload voordat u het verzendt
• Implementeer logica voor opnieuw proberen met exponentiële vertraging voor 5xx-fouten
• Log de volledige foutresponstekst voor foutopsporing
• Stel uw API-sleutel nooit bloot in code aan de clientzijde