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.

Related Articles

asp.net core
Anreichern mit Attributen: ASP.NET Core API-Dokumentation mit Swagger - Teil 3 [Screencast]
Thinktecture Backend- und API-Spezialist Sebastian Gingter zeigt in dieser 10-teiligen Screencast-Serie wie man seine ASP.NET Core 3.1-API mithilfe von Swagger dokumentieren kann. Im dritten Teil sehen wir, wie man die bisher eher rudimentäre Dokumentation aufpeppt. Mit…
Sebastian Gingter
asp.net core
Einbindung: ASP.NET Core API-Dokumentation mit Swagger: Teil 2 [Screencast]
Thinktecture Backend- und API-Spezialist Sebastian Gingter zeigt in dieser 10-teiligen Screencast-Serie wie man seine ASP.NET Core 3.1 API mithilfe von Swagger dokumentieren kann. Nach der Einführung in Teil 1, wird es im zweiten Teil praktisch und wir sehen Code. Im Screencast…
Sebastian Gingter
asp.net core
Einführung: ASP.NET Core API-Dokumentation mit Swagger: Teil 1 [Screencast]
Thinktecture Backend- und API-Spezialist Sebastian Gingter zeigt in dieser 10-teiligen Screencast-Serie wie man seine ASP.NET Core 3.1 API mithilfe von Swagger dokumentieren kann. Der erste Teil befasst sich damit welche Gründe für eine Dokumentation sprechen und wo der…
Sebastian Gingter
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