Crear tu primera API con .NET es más rápido de lo que imaginas. Con unos cuantos comandos en la terminal o un par de clics en Visual Studio, tendrás un proyecto funcional listo para responder peticiones HTTP. Esta guía es para ti si estás dando tus primeros pasos en el desarrollo backend con C#.
¿Cómo verificar que .NET está instalado en tu máquina?
Antes de crear cualquier proyecto, asegúrate de que el entorno esté listo. Abre una terminal en Windows o macOS y ejecuta el comando dotnet. Si todo está bien, verás un conjunto de instrucciones que confirman la instalación.
Desde ahí, puedes verificar detalles más específicos:
dotnet --version te muestra la versión activa. En la grabación se usa la 10.0.1, la más reciente al momento del curso [01:00].dotnet --list-sdks lista todos los SDK instalados en tu máquina.- .NET es retrocompatible, así que con la versión 10 puedes ejecutar proyectos escritos en versiones anteriores sin problema.
¿Qué significa que .NET sea retrocompatible? Que una versión nueva, como la 10, puede correr proyectos creados con versiones más antiguas sin necesidad de reescribir el código.
¿Cómo crear una API con .NET desde la terminal?
El flujo desde el CLI es directo y te enseña qué pasa por debajo. Primero necesitas una carpeta contenedora, porque el comando de creación toma como nombre del proyecto el de la carpeta donde se ejecuta (a menos que uses el parámetro -n).
Los pasos básicos son:
- Crea una carpeta, por ejemplo
Platzi/curso-apis, y entra a ella con cd curso-apis.
- Ejecuta
dotnet new webapi para generar el proyecto con la plantilla base de Web API [02:15].
- Compila con
dotnet build. Recuerda que C# es un lenguaje compilado, así que este paso es obligatorio antes de correrlo.
- Levanta el servidor con
dotnet run.
Cuando termina la ejecución, verás un mensaje indicando que la API está escuchando en un puerto, por ejemplo el 5055. .NET asigna puertos de forma aleatoria desde una lista interna, así que no te preocupes si el tuyo es distinto [03:30].
¿Por qué la raíz de la API no muestra nada?
La plantilla base no incluye una welcome page. Si abres la URL raíz en el navegador, verás una pantalla vacía. Para confirmar que todo funciona, navega al controlador de ejemplo WeatherForecast, que devuelve datos aleatorios de temperatura. Ese pequeño demo es la forma estándar de verificar que el proyecto está corriendo bien.
¿Cómo crear el mismo proyecto desde Visual Studio 2026?
Si prefieres una interfaz gráfica, Visual Studio 2026 te guía con plantillas predefinidas. Selecciona ASP.NET Core Web API, asigna el nombre curso-apis y revisa la configuración antes de crear el proyecto [04:45].
Las opciones clave que debes marcar son:
- Habilitar HTTPS, que viene activado por defecto.
- Elegir la versión del framework, en este caso la 10.
- Activar el soporte para OpenAPI, útil para documentar tu API.
- Marcar la opción Use controllers, porque esa es la plantilla con la carpeta de controladores que vamos a usar.
Existen varias plantillas para crear APIs en .NET, pero la que incluye la carpeta Controllers es la indicada para este flujo. También verás el archivo appsettings.json, donde defines la configuración general del proyecto.
¿Qué es el archivo .http en .NET? Es un archivo que viene incluido en la nueva plantilla y te permite probar tus endpoints (GET, POST, PUT, etc.) directamente desde Visual Studio, sin necesidad de herramientas externas como Postman.
¿Qué pasa al ejecutar el proyecto desde Visual Studio?
Al correrlo, verás una consola similar a la del CLI. En el ejemplo, la API queda escuchando en dos puertos: 7003 por HTTPS y 5245 por HTTP [06:50]. Visual Studio muestra ambas opciones porque puedes consumir la API por cualquiera de los dos protocolos, aunque HTTPS es la opción recomendada.
Navega al endpoint /WeatherForecast y obtendrás la misma respuesta con datos climáticos aleatorios. Esa coincidencia confirma que el resultado es idéntico al del CLI: la diferencia está en el camino, no en el destino.
¿Cuál método elegir, CLI o Visual Studio?
Los dos llegan al mismo punto, pero responden a momentos distintos del aprendizaje:
- El CLI con
dotnet new webapi te da control total, es ligero y funciona igual en Windows o macOS.
- Visual Studio 2026 te ahorra tiempo con una interfaz visual, plantillas configurables y herramientas integradas como el archivo
.http.
Si estás empezando, vale la pena practicar primero con la terminal para entender qué hace cada comando, y después aprovechar Visual Studio para flujos más complejos.
¿Cuál de los dos métodos vas a usar para tu primer proyecto? Cuéntame en los comentarios cómo te fue al ejecutar dotnet run por primera vez.
