# Fehler, Konflikte und Wiederholungen

Fehler beheben, ohne Zugriff auszuweiten oder Schreibaktionen zu duplizieren.

Source: https://docs.getridian.com/de/developers/errors/
Language: de
Reviewed: 2026-09-20

## 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.