REST API Design

Entwirf eine REST API für: [PROJEKT/DOMAIN]

RESSOURCEN: [z.B. Users, Products, Orders]
AUTHENTIFIZIERUNG: [JWT/API Key/OAuth]
FRAMEWORK: [Express/FastAPI/Laravel/Spring Boot]

Für jede Ressource erstelle:
1. **ENDPUNKTE** (RESTful):
   - GET /resource - Liste (mit Pagination, Filter, Sort)
   - GET /resource/:id - Detail
   - POST /resource - Erstellen
   - PUT /resource/:id - Aktualisieren
   - DELETE /resource/:id - Löschen

2. **REQUEST/RESPONSE** Beispiele (JSON)

3. **VALIDIERUNG**: Eingabe-Validierungsregeln

4. **FEHLER-RESPONSES**: Standardisiertes Error-Format
   ```json
   {"error": {"code": "VALIDATION_ERROR", "message": "...", "details": [...]}}
   ```

5. **PAGINATION**: Cursor-based oder Offset-based
6. **RATE LIMITING**: Empfohlene Limits
7. **VERSIONIERUNG**: URL vs Header Strategy
8. **OpenAPI/Swagger**: Schema-Definition

Best Practices: HATEOAS, idempotent Operations, HTTP Status Codes.