Tutorial: Create a web API with ASP.NET Core

Creation of the needed environment to follow and steps described in https://docs.microsoft.com/en-us/aspnet/core/tutorials/first-web-api?view=aspnetcore-5.0&tabs=visual-studio-code#overview

Testing Virtual Machine

Creation of the testing virtual machine, development platform, using Vagrant.

.NET Core Installation

Steps followed from https://docs.microsoft.com/es-es/dotnet/core/install/linux-debian, these steps are embedded in the virtual machine creation.

NuGet

Installation of NuGet package manager for .NET projects and update to latest version

Tutorial Steps

Web API Project Creation

Creation of the project in /vagrant in order to include the project folder in the repository.

dotnet new webapi -o /vagrant/TodoApi
cd /vagrant/TodoApi
dotnet add package Microsoft.EntityFrameworkCore.InMemory

To run the application in Development (refer to ASP.NET Tutorial | Hello World in 10 minutes):

cd /vagrant/TodoApi
dotnet watch run

Update lauchUrl and applicationUrl

Update the launchUrl from swagger to api/TodoItems and applicationUrl from localhost to 0.0.0.0 in order to listen from external connections in all IP addresses of the development virtual machine.

Create the Model Class and Controller

Execute the following steps from the tutorial

• Add a model class
• Add a database context
• Add the TodoContext database context
• Register the database context
• Scaffold a controller

Add Mono Most Recent Stable Packages

Add the latest stable Mono repository in order to get the most recent packages when installing NuGet. Updating NuGet breaks itself because of new packages versions needed.

apt install apt-transport-https dirmngr gnupg ca-certificates
apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
echo "deb https://download.mono-project.com/repo/debian stable-buster main" | tee /etc/apt/sources.list.d/mono-official-stable.list
apt update

Resources

• Download Mono for Debian