Was es bedeutet

PreVOP selbst ist beim Verarbeiten Ihres Requests auf einen unerwarteten Fehler gestoßen. Das ist selten — jede uns bekannte Produktions-Ausnahme ist einem spezifischeren Fehlercode zugeordnet. Wenn Sie das sehen, liegt ein Bug oder ein System-Problem auf unserer Seite vor.

Wann Sie diesen Fehler sehen

• Die Datenbank von PreVOP wurde mitten im Request unerreichbar.
• Eine TLS-Konfigurationsdatei, die für den Upstream-Call benötigt wird, fehlt oder ist nicht lesbar.
• Eine nicht behandelte Ausnahme ist aus dem Request-Handler gekommen (Gateway-seitiger Bug).
• Dem PreVOP-Prozess sind File-Descriptors, Speicher oder eine andere OS-Ressource ausgegangen.

Beispiel-Antwort

HTTP/1.1 500 Internal Server Error
Content-Type: application/problem+json
X-Request-ID: 550e8400-e29b-41d4-a716-446655440000

{
  "type":    "https://errors.prod.prevop.alseda.eu/errors/internal-error",
  "code":    "INTERNAL_ERROR",
  "title":   "Internal server error",
  "status":  500,
  "detail":  "An unexpected error occurred; alseda has been notified"
}

So beheben Sie das Problem

1. Notieren Sie die X-Request-ID aus der Antwort — sie brauchen wir, um den Fehler in unseren Logs zu finden.
2. Schreiben Sie an prevop-support@alseda.com mit dieser ID. Nennen Sie den ungefähren Zeitpunkt in Ihrer Zeitzone, damit wir die Log-Suche schnell eingrenzen können.
3. Retrien Sie nicht im engen Loop — wenn PreVOP in einem degradierten Zustand ist, können Retries das Problem verstärken. Ein Retry nach kurzer Pause ist okay.
4. Bei zeitkritischem Traffic schalten Sie auf einen ggf. vorhandenen sekundären Pfad um, während alseda untersucht.

Verwandte Themen

• Customer API Contract §4.2 — PreVOP-Fehlercodes (Zeile INTERNAL_ERROR)
• Siehe auch: UPSTREAM_UNAVAILABLE — Upstream-seitiger Fehler, der typische Nachbar, wenn das Problem NICHT bei PreVOP liegt.