http://localhost:1313/tags/swagger/ Recent content in Swagger on Yunier's Wiki Hugo en Thu, 18 May 2023 00:00:00 +0000 http://localhost:1313/post/2023/use-custom-openapi-specification-file-in-.net/ Thu, 18 May 2023 00:00:00 +0000 http://localhost:1313/post/2023/use-custom-openapi-specification-file-in-.net/ <p>.NET has the ability to auto-generated <a href="https://swagger.io/specification/">OpenAPI specifications</a> based on your code. You can use different decorators on your code like <a href="https://learn.microsoft.com/en-us/dotnet/api/microsoft.aspnetcore.mvc.producesresponsetypeattribute?view=aspnetcore-7.0">ProducesResponseTypeAttribute</a> or <a href="https://learn.microsoft.com/en-us/dotnet/api/microsoft.aspnetcore.mvc.consumesattribute?view=aspnetcore-7.0">ConsumesAttribute</a> to produce more descriptive response details for web API help pages generated by tools like Swagger.</p> <p>What if you didn&rsquo;t want to use the autogenerated spec, what if you instead wanted to expose an already written spec, perhaps because you follow an <a href="https://blog.postman.com/what-is-api-first-design/">API-first</a> approach to building an API instead of a Code-First approach. How would you expose that OpenAPI file?</p>