API-Dokumentation mit OpenAPI/Swagger am Beispiel von ASP.NET Core

Das Dokumentieren einer API wird oft als mühsame, aber wesentliche Aufgabe angesehen. Mit OpenAPI, vormals Swagger, können wir eine API-Dokumentation angenehm einfach in ASP.NET Core integrieren.

Der Vortrag zeigt, wie eine API-Dokumentation mit Benutzeroberfläche hinzugefügt wird, mit der wir die API testen können. Als Nächstes erfahren wir, wie wir Attribute und Konventionen verwenden, um die generierte OpenAPI-Spezifikation zu verbessern. Abschließend wird gezeigt, wie wir mit der Authentifizierung, Versionierung und Anpassung der Benutzeroberfläche umgehen.