Thinktecture Backend- und API-Spezialist Sebastian Gingter zeigt in dieser vierteiligen Screencast-Serie, wie eine ASP.NET Core 3.0 API versioniert wird. Nach einer Einführung in die API-Versionierung, der Integration in neue Projekte und Hinweisen zur Konfiguration, geht es im letzte Teil um die Einbindung in ein existierendes Projekt und wie man dabei einzelnen Endpunkte von der Versionierung ausnimmt.

Dazu wird ein weiterer Möglichkeit dargestellt, die Version durch den Client zu bestimmen und gezeigt, wie im Code ersichtlich wird welche Version der Client überhaupt gerade abgefragt hat.

im Code ersichtlich ist, welche Version der Client überhaupt gerade abgefragt hat.

Inhalte des Screencasts

  • Einbindung in ein existierendes Projekt: Nicht alle Projekte starten auf der grünen Wiese. Es wird gezeigt, wie API-Versionierung in ein existierendes Projekt eingebunden wird und worauf man achten sollte, wenn Default-Versionen konfiguriert werden, da alte Clients die Versionierung noch nicht kennen und daher keine Version abfragen.
  • Endpunkte von der Versionierung ausschließen: So gehts: Manchmal möchte man Endpunkte explizit von der Versionierung ausschließen, weil sie in allen Versionen der API gleichermaßen zur Verfügung stehen sollen.
  • Custom Header Versioning: Die Versionsauswahl kann so umgestellt werden, dass ein Client die Version nicht mittels Query-Parametern, HTTP-Accept-Headern oder im Pfad auswählen muss, sondern dies über einen individuellen, spezialisierten Header tun kann.
  • Angeforderte Version im Code abfragen: Manchmal ist es notwendig im Code zu unterscheiden, welche Version gerade abgefragt wurde, um ein bestimmtes Verhalten des Endpunktes bei alten Versionen beizubehalten.

Den Demo-Code der Screencast-Serie finden Sie hier.

Wenn Sie in Zukunft die weiteren Artikel, Screeencasts und Webinare von Sebastian Gingter und unserer Experten nicht verpassen möchten, melden Sie sich für unseren Newsletter an.

Kostenloses Cheat Sheet zu API-Dokumenatation mit Swagger zum Download:
Sebastian Gingter hat zum Thema ASP.NET Core API Dokumentation mit Swagger ein Cheat Sheet erstellt, auf dem er kompakt alles Wissenswertes zusammengefasst hat. Melden Sie sich hier zu unseren monatlichen DevNews an und wir senden Ihnen das Cheat Sheet zum Download.

Related Articles

asp.net core
Konfiguration: API-Versionierung mit ASP.NET Core 3.0 - Teil 3 [Screencast]
Thinktecture Backend- und API-Spezialist Sebastian Gingter zeigt in dieser vierteiligen Screencast-Serie wie man seine ASP.NET Core 3.0 API versionieren kann. Nach der Einführung in die Versionierung und der Erläuterung über die Integration in neue Projekte, befasst sich der…
Sebastian Gingter
asp.net core
Einbindung der Versionierung, Controller & Actions: API-Versionierung mit ASP.NET Core 3.0 - Teil 2 [Screencast]
Thinktecture Backend- und API-Spezialist Sebastian Gingter zeigt in dieser vierteiligen Screencast-Serie wie man seine ASP.NET Core 3.0 API versionieren kann. Nach der Einführung in die API-Versionierung, befasst sich der zweite Teil befasst damit, wie Versionierung in ein neues…
Sebastian Gingter
asp.net core
Warum versionieren, Versionsauswahl, Möglichkeiten: API-Versionierung mit ASP.NET Core 3.0 - Teil 1 [Screencast]
Inhalte des Screencasts Warum API-Versionierung? Gründe, die für die Versionierung einer API sprechen, wann man API-Versionierung (nicht) in Betracht ziehen sollte und welche Kriterien dafür sprechen, eine neue Version einzuführen. Versionsauswahl: Es werden vier verschiedene…
Sebastian Gingter
asp.net core
ASP.NET Core Web API Performance - Throughput for Upload and Download
After working with the new ASP.NET Core server and the for a while in a number of projects I run into some performance issues. Actually, it was a throughput issue. It took me some time to figure out whether it is the server or the client responsible for the problems. And the…
Pawel Gerr