ASP.NET Web API is one of the hot topics in the ASP.NET world and many companies use APIs to connect front-end and back-end functionality at a large scale. What is the key element in such integrations? You need to document your web APIs so that they can be understood easily by developers.
In this course, you will be learning about web API documentation using Swagger/OpenAPI concepts from scratch in this course.
You will understand OpenAPI/Swagger and the need for documentation in web API. Learn the various approaches available for documenting a web API, including XML comments, data annotations, and so on. Also, we will use Swagger and Swagger UI tools from the OpenAPI community to create a rich API document.
Then, create an OpenAPI document using Swashbuckle and NSwag in ASP.NET Web API. Learn how to use web API analyzers to guide you in including appropriate attributes for achieving complete documentation and web API conventions to automate and quickly document APIs with minimal effort. Next, understand the steps involved in documenting an API with multiple versions by creating one document per-version.
By the end of this course, you will know how to document a web API project in ASP.NET Core using Swagger/OpenAPI from scratch.
All the resources for this course are available at https://github.com/PacktPublishing/Hands-on-.NET-Web-API-Documentation-…
Understand OpenAPI/Swagger and the need for documentation in web API
Learn the various approaches available to document a web API
Create an OpenAPI document using Swashbuckle in ASP.NET Web API
Create an OpenAPI document using NSwag in ASP.NET Web API
Learn to use Swagger and Swagger UI tools to create a rich API document
Understand the steps involved in documenting an API with multiple versions
For this course, one needs basic knowledge of building web API in ASP.NET Core and basic knowledge of OpenAPI/Swagger specification.