Swagger is a specification and framework implementation for describing, producing, consuming, and visualizing RESTful web services.
- Stackoverflow.com Wiki
This article shows how to document your MVC 6 API using Swagger with Swashbuckle. Per default, it does not use your xml comments in the code and this needs to be configured if required.
SwaggerUI is more that just documentation - it actually allows developers to make authenticated calls to the API.
Swagger is a simple yet powerful representation of your RESTful API. Once integrated with WEB API, it becomes easy to test the API without using any third-party tool. In this post, we will see how to add Swagger to ASP.NET Core Web API.
Document your ASP.NET Core Web APIs with Swagger and auto-generate authenticated clients quickly and easily with Autorest.
For all intents and purposes HTTP and REST are just the implementation detail of the communication protocol. And unless the API you are exposing really maps well to resources which can be accessed as a tree like a filesystem or an object store like S3, treating REST like and end on itself just gets in the way and makes things more complicated than it should.
There are a few easy solutions that you can implement that will actually do all the documentation work for you. Microsoft has their own built-in version of this, however I'm going to focus today on a specification called "Swagger." More specifically, the implementation technology we'll be using to generate the Swagger documentation with the Web Api framework is called "Swashbuckle."