---
name: api-design-discipline
description: "Bei jedem API-Design die 6 REST-Constraints bewusst pruefen, Abweichungen (RPC-Style) in ADR begruenden, Errors nach RFC 7807"
metadata: 
  node_type: memory
  type: feedback
  originSessionId: 7f5ec970-b013-4424-9fec-1a7e770c3103
---

Bei jedem API-Design: Statelessness, Cacheability, Uniform Interface (REST-Constraints aus Fielding's Dissertation) bewusst checken. Abweichungen (z.B. RPC-Style Server-Actions) explizit in ADR begruenden. Error-Responses nach RFC 7807 (Problem Details).

**Why:** KAR-522-Audit Konvergenz aus Sources 1 (12-Factor IV/XII), 8 (OTel), 9 (Next.js), 20 (REST). REST-Constraints sind Industry-Floor — auch wenn nicht alle strikt befolgt, bewusste Auswahl statt Default-RPC-Drift. RFC 7807 verhindert inkonsistente Error-Shapes.

**How to apply:** Pro neuem API-Endpoint oder Route:
- Stateless? Cacheable? Uniform-Interface-konform?
- Wenn nein → ADR mit Begruendung
- Error-Response: `{ type, title, status, detail, instance, ... }` (RFC 7807)
- OpenAPI-Schema falls extern konsumiert
- Auth + Rate-Limit explizit pro Endpoint

Brain-Ref: [[02-Wissen/architecture-audit/20-fielding-rest-dissertation]] · [[02-Wissen/architecture-audit/00-synthese]] · Standing Order 22.05.2026 (KAR-522).