API Versionierung

🔀 API-Versionierung

Neu in v1.1.0 — Versionierte API-Routes mit Deprecation-Headers.

---

Überblick

Alle API-Endpunkte sind ab v1.1.0 unter dem Prefix /api/v1/ erreichbar. Die alten /api/-Routes funktionieren weiterhin, geben aber Deprecation- und Sunset-Headers zurück.

---

Versionierte Routes

GET /api/v1/employees          ← empfohlen
GET /api/v1/schedule/2026/3
GET /api/v1/health

OpenAPI-Dokumentation

• Swagger UI: /api/v1/docs
• ReDoc: /api/v1/redoc
• OpenAPI JSON: /api/v1/openapi.json

---

Deprecation-Headers

Anfragen an unversionierte Routes erhalten:

Deprecation: true
Sunset: 2026-12-31
Link: </api/v1/employees>; rel="successor-version"

---

Frontend-Migration

Das Frontend wurde vollständig auf /api/v1/-Pfade migriert. Externe Integrationen sollten ebenfalls umgestellt werden.

---

Siehe auch

• REST-Referenz im API-Wiki — vollständige Endpunkt-Dokumentation des Pakets openschichtplaner5-api
• Webhook-System — API-Integrationen
• Konfiguration — API-Einstellungen