Ordivis Platform · Schnittstelle

Fehlertypen der Ordivis-Schnittstelle

Die Ordivis-Schnittstelle beantwortet Fehler nach RFC 7807. Jede Fehlerantwort traegt ein Feld type mit einer dieser Adressen — sie ist die dauerhafte Kennung der Fehlerart, nicht bloss ein Verweis.

Die sechs Typen

Adresse	HTTP	Bedeutung
`/errors/not-found`	404	Nicht gefunden
`/errors/validation`	422	Eingabe nicht verwertbar
`/errors/forbidden`	403	Nicht erlaubt
`/errors/domain-rule`	409	Fachliche Regel verletzt
`/errors/rate-limited`	429	Zu viele Anfragen
`/errors/internal`	500	Unerwarteter Fehler

Aufbau einer Fehlerantwort

Was in der Antwort steht

{
  "type":     "https://ordivis.eu/errors/validation",
  "title":    "Validation failed",
  "status":   422,
  "detail":   "…",
  "traceId":  "…"
}

Werten Sie type aus, nicht title: Der Titel ist fuer Menschen und darf sich aendern, die Adresse ist die Kennung und bleibt.

Diese Anwendung meldet nichts nach aussen

Ein Fehler bleibt in Ihrer Installation. Es gibt keinen Dienst bei uns, der Fehlerberichte einsammelt, und keine Telemetrie. Wollen Sie einen Vorgang melden, kopieren Sie ihn selbst aus dem Programm — die Entscheidung darueber liegt bei Ihnen.