Many of us have been using ASP.NET Web API 2 (a popular framework for building RESTful APIs). I have being using that for a couple of years now, especially focused on REST APIs used for different clients such as ASP.NET MVC, JavaScript based UI framework like JQuery, AngularJs, KnockOut, etc, and handheld devices like mobiles, Tablets, etc.

One of the major time consuming tasks is to give proper documentation, unit testing it, and, most importantly, telling the other teams how the APIs are designed and documented.

We always had issues of other teams complaining about how to use these APIs, what are request and response types, how shall they form a JSON request or what is a JSON response? ASP.NET Web API 2 gives us documentation by including help pages; I had used that which actually solved my issues a bit but not to a great extent.

I was looking for a tool to minimize my team's efforts involved in interacting with other teams just to teach them how to use API. I got Swagger; this is an excellent tool for solving my team's efforts.

Swashbuckle is a combination of ApiExplorer and Swagger/swagger-ui and provides a rich discovery, documentation and playground experience to your API consumers.



Some of the features you get with Swashbuckle are: