URL, Header, Sunset und Backward Compatibility
Ungeplante API-Versionierung endet mit /v1, /v2, /v2-new, /v3-beta und einem Team, das nicht mehr weiß, welche Version welche Clients noch nutzen. Klare Versionierungsstrategien, Sunset-Header und Backward-Compatibility-Muster verhindern, dass Versionen zum Wartungsproblem werden.
Inhaltsverzeichnis
- 1. Warum API-Versionierung ein strategisches Problem ist
- 2. URL-Versionierung: /v1, /v2 – Vor- und Nachteile
- 3. Header-Versionierung: Accept und API-Version Header
- 4. Symfony-Routing für mehrere API-Versionen
- 5. Backward Compatibility: Was Breaking Change bedeutet
- 6. Sunset-Header und Deprecation-Kommunikation
- 7. Mehrere API-Versionen in OpenAPI dokumentieren
- 8. Versionierungsstrategien im Vergleich
- 9. Zusammenfassung