Umgang mit API-Fehlern, Wiederholungen und Idempotenz

Plane für den Fehlerfall, nicht nur für den Idealverlauf. Der gefährlichste Fall ist ein uneindeutiger: eine Anfrage, die vor dem Abbruch der Verbindung erfolgreich gewesen sein könnte oder auch nicht.

Verwende einen Idempotenz-Schlüssel bei Bestellanfragen, damit eine sichere Wiederholung nach einem Timeout die bestehende Bestellung zurückgibt, statt eine doppelte Abbuchung zu erzeugen. Wiederhole vorübergehende Fehler (Rate-Limits, temporäre 5xx) mit zunehmendem Backoff und einer Obergrenze.

Brich bei dauerhaften Fehlern wie einer fehlerhaften Anfrage oder unzureichendem Guthaben schnell ab und melde sie an einen Menschen. Diese zu wiederholen, verschwendet nur Zeit. Protokolliere jede Anfrage und Antwort mit ihrer Bestell-ID, damit du später abgleichen kannst.