Fehlerbehandlung

Alle Fehler-Responses verwenden ein einheitliches JSON-Format.

{
  "error": "error_code",
  "error_description": "Beschreibung des Fehlers"
}

HTTP Status Codes

HTTP Status	Error Code	Beschreibung
400	validation_error	Ungültige Request-Daten (fehlende Felder, falsches Format)
401	invalid_client	Ungültiger oder fehlender Access Token
403	access_denied	OAuth-Client wurde widerrufen
403	insufficient_scope	Der Client hat nicht die benötigte Berechtigung
404	not_found	Ressource nicht gefunden
429	rate_limit_exceeded	Zu viele Anfragen. Warte und versuche es erneut.

Hinweis: Bei 429 enthält die Response einen Retry-After Header mit der Wartezeit in Sekunden.

Fehler behandeln

JavaScript

const response = await fetch('https://my.offisy.at/api/oauth/v2/resource/appointments', {
  headers: { 'Authorization': 'Bearer {access_token}' }
});

if (!response.ok) {
  const error = await response.json();
  console.error(`${error.error}: ${error.error_description}`);

  if (response.status === 429) {
    const retryAfter = response.headers.get('Retry-After');
    console.log(`Retry after ${retryAfter} seconds`);
  }
}