Anhang
Fehlercodes
Alle code-Werte dieser API. Jede Zeile hat einen Anker; die type-Adresse einer Fehlerantwort verweist darauf.
| Code | Status | Bedeutung |
|---|---|---|
| nicht_authentifiziert | 401 | Token fehlt, ist abgelaufen oder ungültig. |
| ungueltige_zugangsdaten | 401 | Client-ID oder Secret falsch, oder der Zugang ist widerrufen. |
| scope_fehlt | 403 | Token gültig, aber dieser Zugang hat das nötige Recht nicht. Der fehlende Scope steht im Fehler. |
| objekt_nicht_erlaubt | 403 | Der Zugang ist auf bestimmte Objekte beschränkt; dieses gehört nicht dazu. |
| nicht_gefunden | 404 | Nicht vorhanden oder einem anderen Betrieb zugeordnet — beide Fälle antworten gleich. |
| zeitraum_nicht_verfuegbar | 409 | Belegt, gesperrt oder vom Verkauf ausgenommen. Es ist keine halbe Buchung entstanden. |
| idempotenz_in_arbeit | 409 | Ein Aufruf mit diesem Idempotency-Key läuft noch. Kurz warten, dann wiederholen. |
| abo_besteht_bereits | 409 | Für diese Adresse besteht schon ein aktives Webhook-Abo dieses Zugangs. |
| waehrung_fehlt | 422 | Dem Objekt, Rate-Plan oder der Buchung ist keine Währung zugeordnet — ein Datenfehler. |
| ungueltige_anfrage | 422 | Formal in Ordnung, fachlich nicht erfüllbar. Die Begründung steht in detail. |
| validierung_fehlgeschlagen | 422 | Die Anfrage passt nicht zum Schema. felder nennt, welches Feld. |
| zu_viele_anfragen | 429 | Rate-Limit erreicht. Retry-After sagt, wann es weitergeht. |
| nicht_konfiguriert | 503 | Der Dienst kann die Anfrage nicht sicher bearbeiten. Kein Weiterlaufen ohne Prüfung. |