major update

2026-03-04 15:56:58 +01:00
parent 16759a2732
commit 8f4dd5840d
478 changed files with 24313 additions and 8201 deletions
--- a/docs/api.md
+++ b/docs/api.md
@@ -1,6 +1,6 @@
 # REST-API (v1)

-Letzte Aktualisierung: 2026-02-21
+Letzte Aktualisierung: 2026-02-25

 ## Single Source of Truth

@@ -15,6 +15,19 @@ Diese Datei ist die verbindliche technische Referenz für:
 - Statuscodes
 - Auth-Header

+## Fehlerhülle (API-Standard)
+
+Fehlerantworten nutzen ein einheitliches Schema:
+
+- `ok: false`
+- `request_id: <uuid>`
+- `error_code: <stable_machine_code>`
+- `details: { ... }`
+- kein Legacy-Feld `error` oder `errors`
+
+`request_id` wird zusaetzlich als Header `X-Request-Id` geliefert.
+Die `request_id` kommt zentral aus `RequestContext` und korreliert API-Fehler mit Audit-Einträgen.
+
 ## API-Doku im Admin

 - UI: `/admin/api-docs`