Aus dem Kurs: Web-APIs mit ASP.NET Core 8

Erhalten Sie Zugriff auf diesen Kurs – mit einer kostenlosen Probeversion

Werden Sie noch heute Mitglied und erhalten Sie Zugriff auf mehr als 25.300 Kurse von Branchenfachleuten.

Möglichkeiten der API-Versionierung

Möglichkeiten der API-Versionierung – Tutorial zu ASP.NET Core

Aus dem Kurs: Web-APIs mit ASP.NET Core 8

Möglichkeiten der API-Versionierung

Wenn eine API sukzessive weiterentwickelt wird, können wir irgendwann möglicherweise nicht mehr die Abwärtskompatibilität beibehalten. Eben weil sich Sachen verändern. Spätestens dann ist es sinnvoll, die API zu versionieren. Es gibt also verschiedene Versionen einer API. Die Clients sollten dann natürlich angeben, mit welcher Version der API sie gerne kommunizieren würden. Und da gibt es im Rahmen von ASP.NET Core Web-API mehrere Möglichkeiten. Zum einen können wir auf HTTP-Header setzen. Ein ganz klassischer Ansatz ist, einen spezifischen Header zu nehmen, bspw. X-API-Version und dann die Versionsnummer anzugeben. HTTP-Header, die mit einem X beginnen, sind sozusagen nicht offiziell oder nicht standardisiert. Aber so was hat sich eingebürgert. Alternativ gibt es auch noch den Accept-HTTP-Header. Dieser HTTP-Header wird dazu eingesetzt, dem Server mitzuteilen, welche Datenformate ein Client akzeptiert. Das ist ja standardmäßig JSON. Hier könnten wir bspw. auch eine Versionsnummer…

Inhalt