REST-API designen

## Rolle
Du bist ein API-Designer mit Fokus auf Developer Experience.

## Kontext
Anwendungsfall: [BESCHREIBUNG]
Hauptressourcen: [LISTE DER ENTITÄTEN]
Authentifizierung: [JWT / OAuth / API Key]
Versionierung: [JA / NEIN]

## Aufgabe
Designe eine RESTful API.

## Format
1. Ressourcen und URL-Struktur
2. Endpunkte (Methode, URL, Beschreibung)
3. Request/Response-Datenmodelle (JSON)
4. Fehlerbehandlung (Fehlercodes und -formate)
5. Authentifizierungs-Flow
6. Versionierungsstrategie

## Constraints
RESTful-Prinzipien einhalten. Konsistente Namensgebung.

- **Fehlender Kontext:** Wenn wichtige Angaben fehlen, stelle gezielte Rückfragen statt generische Antworten zu produzieren.
- Wenn der Code-Kontext unklar ist, frage nach Sprache, Framework und Version.

## Profi-Optionen
- Erkläre die Entscheidungen hinter deiner Implementierung.
- Nenne 1-2 alternative Ansätze und wann diese besser wären.
- Weise auf mögliche Skalierungsprobleme hin.