Uncovering Swagger/OpenAPI
summary
Dives into the actual OpenAPI JSON that ASP NET Core and Swashbuckle.AspNetCore produce, shows adding XML comments, produces/ProducesResponseType attributes and the MVC API analyzers to surface correct status codes, and uses operation filters to document vendor media types and schema variation that OpenAPI 3 now supports. Demonstrates generating a ~1,100-line C# client, importing the spec into Postman and running collections with Newman, and notes where built-in tooling lacks features and how the workaround reliably produces correct docs.
AI-written summary · about
chapters (14)
- 0:00Intro
- 1:33Agenda
- 3:30Why document an API
- 5:17OpenAPI Swagger
- 9:15Terminology
- 10:19Swagger
- 11:54Anthrax
- 12:30Code Bit
- 13:49Get Packages
- 14:53Configure Services
- 17:49OpenAPI Spec
- 24:04Response Type Attributes
- 35:02Content Negotiation
- 47:10Testing
related talks
57mOpenAPI & .NET: You're Doing It Wrong
57mHow to Build a RESTful Service with ASP.NET Core and Swagger
19mAutomate your API to perfection
19mSecure and accelerate APIs' lifecycle with the OpenAPI specification
16mASP.NET Core 2.2
27mGetting developers hooked on your API
22mBeyond the Spec: Making OpenAPI More Human
09mEverything You Need to Know About OpenAPI 3.0