Was es bedeutet

PreVOP hat den Upstream-VOP-Provider erreicht, die Antwort war aber nicht verwertbar — entweder ein 5xx-Status, ein nicht parsbarer Body, oder die TCP-/TLS-Verbindung wurde nicht abgeschlossen. Das ist die Auffang-Kategorie für „Upstream hat sich schlecht verhalten“ und meist vorübergehend.

Wann Sie diesen Fehler sehen

• Der Upstream-Provider hat einen nicht-2xx-HTTP-Status zurückgegeben, den PreVOP keinem spezifischeren Fehler (FORMAT_ERROR, CLIENT_INVALID, ...) zuordnen konnte.
• Der Upstream-Response-Body konnte nicht als erwartetes JSON-Schema geparst werden.
• Der TLS-Handshake mit dem Upstream ist fehlgeschlagen — abgelaufenes Zertifikat, falsche CA, Cipher-Mismatch.
• Die TCP-Verbindung wurde mitten in der Antwort abgebrochen, oder DNS-Auflösung für den Upstream ist fehlgeschlagen.
• Ein geplanter oder ungeplanter Upstream-Ausfall ist aktiv; alseda erkennt und kommuniziert diese typischerweise.

Beispiel-Antwort

HTTP/1.1 502 Bad Gateway
Content-Type: application/problem+json
X-Request-ID: 550e8400-e29b-41d4-a716-446655440000
X-Rejected-By-Provider: false

{
  "type":    "https://errors.prod.prevop.alseda.eu/errors/upstream-unavailable",
  "code":    "UPSTREAM_UNAVAILABLE",
  "title":   "Upstream provider unavailable",
  "status":  502
}

So beheben Sie das Problem

1. Senden Sie den Request mit einer neuen X-Request-ID erneut. Die meisten UPSTREAM_UNAVAILABLE-Antworten sind transient und der Retry gelingt.
2. Bei dauerhaften Fehlern Backoff — wenn mehrere Retries in Folge 502 liefern, pausieren Sie 30–60 Sekunden; nicht im engen Loop hämmern.
3. Halten die Fehler über mehrere Minuten an, gehen Sie von einem Upstream-Ausfall aus und prüfen Sie einen ggf. verfügbaren alseda-Status-Kanal.
4. Kontaktieren Sie alseda mit der X-Request-ID eines Fehl-Aufrufs, damit wir den Fehler in unseren Upstream-Logs korrelieren können.

Verwandte Themen

• Customer API Contract §4.4 — UPSTREAM_UNAVAILABLE-Beispiel + Retry-Empfehlung
• Siehe auch: UPSTREAM_TIMEOUT — gleiche Klasse von Fehler, aber speziell wenn der Upstream nicht rechtzeitig geantwortet hat.