Über diese Screencast-Serie
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.
Screencast-Serie:
- Einführung ⬅
- Einbindung
- Anreichern einer Doku mit Attributen
- Anreichern einer Doku mit XMLDoc
- Anreichern einer Doku mit Code
- Dokumentation versionierter APIs
- Einbindung von Authentication und Authorization
- Swagger-UI anpassen
- Code-Generierung aus der Dokumentation
- Verwendung der Dokumentation für Postman-Tests
Screencast: Gründe für die Dokumentation & der Unterschied zwischen OpenAPI und Swagger
Zum nächsten Teil: Einbindung
Im zweiten Teil wird es praktisch: Anhand eines konkreten Beispiels wird im Code gezeigt werden, wie man eine Swagger-Dokumentation mit UI in sein Projekt einbinden kann.