API Versioning
API-Versioning verwaltet Schnittstellenänderungen, sodass neue Versionen alte Clients nicht brechen – üblicherweise via URL-Pfad, Header oder Query-Parameter.
Zweck
Verwaltet die API-Evolution und gewährleistet Abwärtskompatibilität und sanfte Migration.
Mechanismus
URL-Pfad: /v1/users (explizit, einfach). Header: Accept: application/vnd.api+json;version=1 (RESTful). Query: ?version=1. Semantic Versioning: major bricht Kompatibilität, minor ergänzt, patch repariert. Alte Versionen werden nach Übergangsphase deprecated.
Anwendungsfälle
- API-Verwaltung
- Abwärtskompatibilität
- Versionsevolution