Api Event Katalog
Sammelwerk zur Enterprise-Master-Reihe. Markdown und HTML sind synchron erzeugt; technische Ordner bleiben stabil.
API- und Event-Katalog
Dieser Katalog beschreibt typische API- und Event-Verträge der Gesamtplattform.
API- und Event-Übersicht
| API / Vertrag | Typ | Zweck | Event | Hinweis |
|---|---|---|---|---|
| POST /policies | Command | Policy erstellen | PolicyCreated | Idempotency-Key empfohlen |
| POST /claims | Command | Schaden melden | ClaimRegistered | Anhänge in Storage |
| POST /payments | Command | Zahlung buchen | PaymentBooked | Ledger muss idempotent sein |
| GET /invoices/{id} | Query | Rechnung lesen | - | Read Model |
| POST /shipments | Command | Versand auslösen | ShipmentCreated | Tracking ID |
| POST /legacy/migrate | Command | Migration starten | LegacyRecordMigrated | ACL verwenden |
| GET /health | Operations | Gesundheit prüfen | - | Liveness/Readiness getrennt |
Konventionen
- Jede schreibende Operation sollte eine Correlation-ID tragen.
- Kritische Commands sollten idempotent sein.
- Events beschreiben Vergangenes:
PaymentBooked, nichtBookPayment. - Fehlerantworten sollten fachlichen Code, technische Korrelation und verständliche Nachricht enthalten.