# Absagen des Gateways

> Die sechs typisierten Absagen: wer entscheidet, welcher HTTP-Status, ob sie sich erholt.


Absagen sind Antworten. Nur Fehler des Aufrufers sind 4xx; eine Absage der Domäne ist eine Antwort mit Körper; ein erschöpftes Budget bleibt 200, weil es sich nicht mit der Zeit erholt.

| `error` | Wer entscheidet | HTTP (JSON-Hülle) | Erholt sich |
|---|---|---|---|
| `not-found` | die Domäne | 200 | nein, die Frage war falsch |
| `invalid-input` | die Domäne, vor jeder Abfrage | 200 | nein |
| `upstream-unavailable` | die Domäne: der Bund antwortete nicht oder fehlerhaft | 200 | vielleicht, Zustand der Quelle |
| `upstream-busy` | die höfliche Bremse gegen den Bundes-Endpunkt | 200 + `retry_after_ms` | ja, das Gewicht wird zurückerstattet |
| `budget-exhausted` | das Gateway | 200 | nein, neue Sitzung |
| `rate-limited` | das Gateway | 429 + `Retry-After` | ja, nach `retry_after_ms` |

Die eine Absage mit eigenem HTTP-Status:

```text
HTTP/1.1 429 Too Many Requests
Retry-After: 2

{"error": "rate-limited", "detail": "…", "retry_after_ms": 1500}
```

Die Werte sind Beispiel, die Form ist die des Gateways.

---

Quelle: docs/de/reference/refusals.md