Referenz · Nachschlagen, während man arbeitet
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:
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.