I would like to show just how easy it is to add testing and documentation to your Asp.Net Core API using Swagger.
The reason I chose Swagger is simply that it is the largest framework of API developer tools for the OpenAPI specific which allows rapid documentation and testing of APIs with great ease.
For reference check out their website @ https://swagger.io/
First we want to add the Swashbuckle package from Nuget.
Right click your API project and click Manage Nuget Packages
Under the Browse tab search for Swashbuckle.AspNetCore
Once found click install
Once installed we want to add the Swashbuckle namespace ‘Swashbuckle.AspNetCore.Swagger’ to our Startup class and in the ConfigureServices method the following:
[csharp]
services.AddSwaggerGen(c =>
{
c.SwaggerDoc(“v1”, new Info { Title = “[Title]”, Version = “v1” });
});
[/csharp]
Replacing [Title] with the Title you would like to set
Next, In the Configure method within the scope of the env.IsDevelopment() check add
[csharp]app.UseSwagger();
app.UseSwaggerUI(options =>
{
options.SwaggerEndpoint(“/swagger/v1/swagger.json”, “[Name]”);
});
[/csharp]
Replacing [Name] with the API spec you would like to set
To try it out simply select one of the buttons corresponding to one of your API methods
Click the ‘Try it out’ button on top right
Then hit the Execute button
That’s it!
We’ve just added swagger, which will dynamically update as you add, remove or update your API removing the maintenance of separate documentation processes – fantastic.