Introducción
En este capítulo aprenderemos a crear un proyecto ASP.NET Core Web API utilizando Visual Studio Code y la interfaz de línea de comandos de .NET (.NET CLI).
Este capítulo es opcional para quienes prefieran trabajar con Visual Studio. Sin embargo, Visual Studio Code ofrece una alternativa ligera, multiplataforma y ampliamente utilizada para el desarrollo con ASP.NET Core.
¿Qué es .NET CLI?
.NET CLI (Command Line Interface) es un conjunto de herramientas que permite crear, compilar, ejecutar y administrar proyectos .NET desde una terminal.
Entre las tareas más comunes que podemos realizar se encuentran:
Crear proyectos.
Restaurar dependencias.
Compilar aplicaciones.
Ejecutar aplicaciones.
Instalar paquetes NuGet.
Publicar proyectos.
A lo largo del curso utilizaremos frecuentemente esta herramienta.
Abrir una terminal
Para comenzar, necesitamos una terminal.
En Windows
Presiona:
Windows + R
Escribe:
cmd
y presiona Enter.
Crear el proyecto Web API
Ubícate en la carpeta donde deseas crear el proyecto y ejecuta el siguiente comando:
dotnet new webapi -n PeliculasAPI --use-controllers
Explicación del comando
dotnet new webapi: crea un nuevo proyecto Web API.
-n PeliculasAPI: define el nombre del proyecto.
--use-controllers: indica que utilizaremos controladores en lugar de Minimal APIs.
Al finalizar, .NET CLI creará la estructura inicial del proyecto.
Abrir el proyecto en Visual Studio Code
Accede a la carpeta recién creada:
cd PeliculasAPI
Luego abre el proyecto utilizando Visual Studio Code:
code .
La instrucción . indica que se abrirá la carpeta actual.
Ejecutar la aplicación
Abre una terminal integrada en Visual Studio Code desde:
Terminal → New Terminal
o utilizando el atajo:
Ctrl + `
Luego ejecuta:
dotnet run
Después de unos segundos aparecerá una salida similar a:
Now listening on: https://localhost:xxxx
donde xxxx representa el puerto asignado por ASP.NET Core.
Probar el endpoint predeterminado
ASP.NET Core genera automáticamente un controlador de ejemplo llamado:
WeatherForecast
Abre la URL mostrada por la aplicación y agrega:
/weatherforecast
Por ejemplo:
https://localhost:7001/weatherforecast
Deberías obtener una respuesta en formato JSON similar a:
[
{
"date": "2026-08-11",
"temperatureC": 25,
"summary": "Warm"
}
]
Esto confirma que la API está funcionando correctamente.
Instalar Swagger
Aunque es posible probar los endpoints directamente desde el navegador o mediante herramientas como Postman, utilizaremos Swagger porque proporciona una interfaz visual muy cómoda para explorar y ejecutar peticiones contra la API.
Instalar el paquete NuGet
Desde la terminal ejecuta:
dotnet add package Swashbuckle.AspNetCore
Este comando descargará e instalará la biblioteca Swagger para ASP.NET Core.
Configurar Swagger en Program.cs
Abre el archivo:
Program.cs
Localiza la configuración de OpenAPI generada por defecto y reemplázala por la configuración de Swagger.
Registrar los servicios
Agrega:
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
Habilitar Swagger
Dentro de la configuración de la aplicación agrega:
app.UseSwagger();
app.UseSwaggerUI();
Un ejemplo completo de Program.cs sería:
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
var app = builder.Build();
if (app.Environment.IsDevelopment())
{
app.UseSwagger();
app.UseSwaggerUI();
}
app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();
app.Run();
Ejecutar automáticamente los cambios durante el desarrollo
Cuando realizamos modificaciones en el código, normalmente tendríamos que detener la aplicación y volver a ejecutarla.
Para evitar esto, .NET proporciona una herramienta llamada Hot Reload mediante el comando:
dotnet watch run
Este comando observa los cambios realizados en el proyecto y recompila automáticamente la aplicación cuando detecta modificaciones.
Esto acelera considerablemente el desarrollo.
Acceder a Swagger
Una vez iniciada la aplicación, abre el navegador y navega a:
https://localhost:xxxx/swagger
sustituyendo xxxx por el puerto asignado a tu proyecto.
Aparecerá una interfaz similar a:
Swagger UI
└── WeatherForecast
Probar un endpoint desde Swagger
Para ejecutar una petición:
Expande el endpoint deseado.
Haz clic en Try it out.
Presiona Execute.
Swagger mostrará:
La URL utilizada.
Los parámetros enviados.
El código de respuesta HTTP.
El contenido devuelto por la API.
Por ejemplo:
200 OK
junto con la respuesta en formato JSON.
Alternativas a Swagger
Aunque Swagger será la herramienta utilizada durante este curso, existen otras opciones para probar APIs REST.
Postman
Permite crear colecciones de peticiones y automatizar pruebas.
Archivos HTTP
Visual Studio Code permite crear archivos:
peticiones.http
para ejecutar solicitudes HTTP directamente desde el editor.
Navegador
Para peticiones GET simples, también es posible utilizar directamente un navegador web.
Resumen
En este capítulo creamos una API utilizando ASP.NET Core 9, Visual Studio Code y .NET CLI.
Los comandos utilizados fueron:
Crear el proyecto
dotnet new webapi -n PeliculasAPI --use-controllers
Abrir el proyecto
code .
Ejecutar la aplicación
dotnet run
Ejecutar con recarga automática
dotnet watch run
Instalar Swagger
dotnet add package Swashbuckle.AspNetCore
Finalmente, configuramos Swagger para visualizar y probar los endpoints de forma gráfica mediante la URL:
https://localhost:xxxx/swagger
Con esto ya tenemos listo nuestro backend desarrollado con ASP.NET Core 9 y preparado para comenzar a implementar la funcionalidad de la aplicación de películas que construiremos a lo largo del curso.
