DEV Community

Cover image for .Net Core 3 - Part 1 - Swagger
LUCIANO DE SOUSA PEREIRA
LUCIANO DE SOUSA PEREIRA

Posted on • Originally published at lucianopereira.netlify.com

8

.Net Core 3 - Part 1 - Swagger

titulo
In this series, I will explain how to create a .Net Core 3 web API connected with a database and deployed to a remote server. The first step is to integrate it with Swagger by using the Swashbuckle package.

The full example can be downloaded in this GitHub repository: NetCore3-Swagger.

Technologies

Topics

.Net Core 3

Download the Visual Studio 2019 here and install it.
Create a new project:

netcore01
Choose ASP.Net Core Web Application:
netcore02
Name the project and configure the local path:
netcore03
Select an empty .Net Core project and uncheck the HTTPS and Docker support options:

netcore04

After the solution be compiled, create a folder named "Controllers" and add into it a class named "TestController" with an async method:

netcore07

Now, let's configure the "Startup" class:

netcore08

Run the project in debug mode and access the URL below:

http://localhost:<API-PORT>/api/Test

If the "OK!" message be displayed in the browser, our web API is running!

Swagger

Inside the Visual Studio 2019, open the Package Manager Console and run the following commands to install the Swashbuckle version compatible with .Net Core 3:

Install-Package Swashbuckle.AspNetCore -Version 5.0.0-rc3
Install-Package Swashbuckle.AspNetCore.Filters -Version 5.0.0-rc3
Install-Package Swashbuckle.AspNetCore.Annotations -Version 5.0.0-rc3

Open the "Startup" class again and modify the "ConfigureServices" method:

swagger01

And the "Configure" method as well:

swagger02

Open the project's properties window, go to "Debug" and type "swagger" inside the input field above the environment variables list:

swagger04

Inside the "TestController", put a simple annotation above the "Get" method:

swagger03

Now, let's run the project again. The Swagger page will open in this URL:

http://localhost:<API-PORT>/swagger/index.html

This will be the result:
swagger08
Try the "Get" method and the "OK!" message will return from the API.
swagger09

Conclusion

In 10 minutes, you were able to create a .Net Core 3 web API with Swagger. In the next chapter, we will connect it with a remote MySQL database.

Image of Timescale

🚀 pgai Vectorizer: SQLAlchemy and LiteLLM Make Vector Search Simple

We built pgai Vectorizer to simplify embedding management for AI applications—without needing a separate database or complex infrastructure. Since launch, developers have created over 3,000 vectorizers on Timescale Cloud, with many more self-hosted.

Read full post →

Top comments (1)

Collapse
 
dev3l profile image
Justin L Beall

Great tutorial! I had some trouble getting the Swagger documentation working using my Mac.

I was able to follow and get to the same point:
docs.microsoft.com/en-us/aspnet/co...

Image of Docusign

🛠️ Bring your solution into Docusign. Reach over 1.6M customers.

Docusign is now extensible. Overcome challenges with disconnected products and inaccessible data by bringing your solutions into Docusign and publishing to 1.6M customers in the App Center.

Learn more