Creación de un proyecto de API web de ASP.NET Core mediante la CLI de .

NET Core

Escribir dotnet new y presionar ENTER.

dotnet new muestra una lista de las plantillas disponible y el nombre corto de la misma, así
como el lenguaje de programación predeterminado.

Como se puede ver en la imagen, se nos proporciona una plantilla llamada ASP.NET Core
Web API, y para crear ese proyecto podemos usar el comando webapi (nombre corto de la
plantilla). El lenguaje de programación predeterminado para este proyecto de API web es C#,
pero se puede seleccionar el lenguaje F#.

Se puede crear un proyecto de API web de dos maneras:

dotnet new webapi

Se creará un nuevo proyecto con el nombre predeterminado.

dotnet new webapi –name NOMBRE_DEL_PROYECYO

Se creará un proyecto con el nombre indicado.
Ahora se puede ver una carpeta con el nombre del proyecto (en este caso, el nombre de la
carpeta es MyFirstWebAPIProject) y dentro de esa carpeta se encuentran los archivos y
carpetas del proyecto predeterminados proporcionados por la plantilla ASP.NET Core Web API,
como se muestra en la siguiente imagen:

Ahora, para abrir el proyecto, desde el Command Prompt vamos hasta la carpeta donde se creó
el proyecto y escribimos: code .
Este abrirá el proyecto en Visual Studio Code como se muestra en la imagen a continuación.
Ahora para construir y ejecutar el proyecto API web de ASP.NET Core mediante la CLI de .NET
Core, abrimos una nueva terminal. Desde el menú Terminal, seleccionamos la opción Nueva
Terminal como se muestra en la imagen a continuación:

Se abrirá la ventana de la terminal como se muestra en la imagen a continuación. 

En la terminal, escribimos dotnet build y presionamos ENTER. Este comando se utiliza para

construir un proyecto existente.
Al finalizar la compilación del proyecto obtendremos el siguiente mensaje:

Para ejecutar el proyecto, escribimos en la terminal dotnet run y presionamos ENTER como
se muestra en la imagen a continuación:

Luego obtendremos los siguientes mensajes:

En este caso la aplicación ASP.NET Core Web API se ejecuta en los puertos 5001 y 5000:

https://localhost:5001
http://localhost:5000

Podemos presionar CTRL y hacer click con el mouse en cualquier de las dos URLs mostradas y
se abrirá el navegador por defecto mostrando un error 404.
Simplemente completamos la URL colocando /swagger al final y presionamos ENTER y
obtendremos la siguiente página web.

El swagger mostrará los detalles de todos los métodos disponibles en el API web. Como puede
ver en la imagen de arriba, muestra una API, es decir, /WeatherForecast y el tipo es GET
(Obtener). 

Hacemos click en la API /WeatherForecast para ver los detalles como se muestra en la imagen:
Podremos ver los detalles de este método en el API como se muestra en la imagen:

Nota: Swagger también es una herramienta del cliente API y con Swagger también se pueden
probar los métodos del API web. Swagger se instala de manera predeterminada en el proyecto.
Para probar la API, es decir, la API WeatherForecast usando swagger, hacemos click en el
botón Try it out como se muestra en la imagen:

Luego hacemos click en el botón Execute como se muestra en la imagen:

Obtendremos una respuesta donde veremos la URL de la solicitud, el cuerpo de la respuesta, el
código de estado de la respuesta y los encabezados de la respuesta.

Incluso si deseamos, podemos directamente indicar la URL de solicitud en cualquier navegador

y veremos la respuesta del API.