Fehler, Konflikte und Wiederholungen

Vor einer Wiederholung einordnen

Situation	Lösungsweg
Ungültige Eingabe oder unbekannte Zeitzone	Anfrage korrigieren; fehlende Absicht beim Nutzer klären
Abgelaufene/widerrufene Autorisierung	Refresh oder Neuverbinden; Zugriff nicht ausweiten
Ausgeschlossener Kalender oder unzulässige Aktion	Ablauf ändern oder passende ausdrückliche Freigabe erhalten
Parallele Änderung / ETag-Konflikt	Aktuellen Termin lesen, vergleichen und entscheiden
Anbieterdrosselung oder vorübergehender Fehler	Mit Abstand wiederholen; vorhandene Wiederholhinweise beachten
Timeout nach möglichem Schreiben	Ergebnis als unklar behandeln; prüfen oder mit gleichem Aktionsschlüssel wiederholen

Aktionsidentität erhalten

Eine Anlagenwiederholung ist dieselbe beabsichtigte Aktion. Behalte ursprüngliche requestId und Nutzlast. Ein neuer Schlüssel beschreibt eine neue Anlage und kann ein Duplikat erzeugen. Geänderte Eingaben mit altem Schlüssel können als Konflikt abgelehnt werden. Versprich keine Exactly-once-Semantik über den dokumentierten Anbieterpfad hinaus.

Änderungen und Löschungen haben anbieterspezifische Parallelitätsgrenzen. CalDAV nutzt starke ETags und bedingte Anfragen, um andere Bearbeitungen nicht still zu überschreiben. Ein bereits gelöschtes Objekt kann als nicht mehr vorhanden gemeldet werden, statt als neu ausgeführte Löschung.

Unvollständige Verfügbarkeit ist keine freie Zeit

Kann ein angeforderter Kalender nicht geprüft werden, darf der Client nicht behaupten, dass alle Kalender frei seien. Leeres Anbieterergebnis, Rechteverweigerung und fehlgeschlagener Abruf bedeuten Unterschiedliches.

Ohne Inhaltskopien diagnostizieren

Erfasse vorhandene Request-ID, Aktion, Anbieter, Zeitpunkt und bereinigten Fehler. Protokolliere keine Tokens, App-Passwörter, vollständigen Anbieterantworten oder Terminbeschreibungen. Die REST-Schnittstelle bietet noch nicht den vollständigen geplanten Partnervertrag für Fehler und Limits; behandle die tatsächliche Antwort statt eines zukünftigen Schemas.