aspnet api versioning

ASP.NET API Versioning

Schauen Sie sich die Ankündigung zu bevorstehenden Änderungen an

Das "ASP" -Projekt, das formell als ASP.NET-API-Versioning bezeichnet wird, bietet Ihnen eine leistungsstarke, aber benutzerfreundliche Methode zum Hinzufügen von API-Versionssemantik zu Ihren neuen und vorhandenen REST-Diensten, die mit ASP.NET erstellt wurden. Die API -Versioning -Erweiterungen definieren einfache Metadatenattribute und Konventionen, mit denen Sie beschreiben, welche API -Versionen von Ihren Diensten implementiert werden. Sie müssen keine neuen Routing -Konzepte lernen oder die Art und Weise ändern, wie Sie Ihre Dienste heute in ASP.NET implementieren.

Die Standard -API -Versionsversionskonfiguration entspricht der Versioning -Semantik, die von den Microsoft -REST -Richtlinien beschrieben wird. Es stehen auch eine Reihe von Anpassungs- und Erweiterungspunkten zur Verfügung, um Übergangsdienste zu unterstützen, die in der Vergangenheit möglicherweise keine API -Versioning unterstützt oder die API -Versioning mit Semantik unterstützt haben, die sich von den Microsoft -REST -Versionsrichtlinien unterscheiden.

Die unterstützten Aromen von ASP.NET sind:

• ASP.NET CORE

  Fügt API -Versioning zu Ihren ASP.NET -Kernminimal -API -Anwendungen hinzu

• ASP.NET CORE MVC

  Fügt API -Versioning zu Ihren ASP.NET Core MVC (CORE) -Anwendungen hinzu

• ASP.Net Core und Odata

  Fügt die API -Versioning zu Ihren ASP.NET -Core -Anwendungen mit Odata v4.0 hinzu

• ASP.NET -Web -API

  Fügt Ihren Web -API -Anwendungen eine API -Versionierung hinzu

• ASP.NET -Web -API und Odata

  Fügt Ihre Web -API -Anwendungen API -Versionen mit Odata v4.0 hinzu

Dies ist auch die Heimat der ASP.NET -API -Versioning -API -Explorer, mit der Sie Ihre REST -APIs einfach mit OpenAPI dokumentieren können:

• ASP.NET Core Versioned API Explorer

  Fügt Ihren ASP.NET -Kernanwendungen zusätzliche API -Explorer -Unterstützung hinzu

• ASP.NET CORE mit Odata API Explorer

  Fügt Ihren ASP.NET -Kernanwendungen mit Odata v4.0 zusätzliche API -Explorer -Unterstützung hinzu.

• ASP.NET Web API Versioned API Explorer

  Ersetzt den Standard -API -Explorer in Ihren Web -API -Anwendungen

• ASP.NET -Web -API mit Odata API Explorer

  Fügt Ihren Web -API -Anwendungen einen API -Explorer mit Odata v4.0 hinzu

Die clientseitigen Bibliotheken erleichtern es einfach, API-Versionen-bewusstes HTTP-Clients zu erstellen.

• HTTP -Client -API -Versioning -Erweiterungen

  Fügt den HTTP -Clients die Unterstützung von API -Versionen hinzu

Dokumentation

Weitere Beispiele, Dokumentation und Anweisungen im Wiki finden Sie zusätzliche Beispiele, Dokumentation und Einstiegsanweisungen.

Diskussion

Haben Sie eine allgemeine Frage, einen Vorschlag oder ein anderes Feedback? Schauen Sie sich an, wie Sie einen Beitrag leisten können.

Verhaltenskodex

Dieses Projekt hat den vom Mitwirkenden Covenant definierten Verhaltenskodex übernommen, um das erwartete Verhalten in unserer Community zu klären. Weitere Informationen finden Sie im Verhaltenskodex der .Net Foundation.

Lizenz

Dieses Projekt ist unter der MIT -Lizenz lizenziert.

.NET Foundation

Dieses Projekt wird von der .NET Foundation unterstützt.

---

Wenn Sie ein vorhandener Benutzer sind, stellen Sie bitte sicher, dass Sie die Versionshinweise zwischen allen wichtigen und kleinen Paketveröffentlichungen überprüfen.

Logo von Sacramento Design funktioniert