Web API – P3.NET

Documenting Web APIs with Swagger

Published on February 7, 2016 Author Michael

A while back I posted an article on how to extend the existing help pages generated by Visual Studio for Web API projects to use reflection instead of XML documentation. One of the limitations of that approach was that you could not test the APIs directly. You had to use SoapUI or equivalent. Since then… Continue reading Documenting Web APIs with Swagger →

Documenting Web APIs

Published on November 14, 2015 Author Michael

Prerequisite: This post assumes you understand what web APIs are, what they are designed for and how to write them. If not then take a look at this MSDN article first. In order for web APIs to be useful they need documentation. Unlike traditional APIs there is no function signatures to look at. Even if… Continue reading Documenting Web APIs →