Creación de una API REST con ASP.NET Core Paso a Paso

 

🚀 ¿Qué es una API REST?

Una API REST (Representational State Transfer) es una forma de comunicar aplicaciones a través de HTTP. En ASP.NET Core, podemos construir APIs de manera sencilla, rápida y potente, utilizando las herramientas modernas del ecosistema .NET.

---

🧱 ¿Qué necesitas para comenzar?

✅ Visual Studio 2022+ o VS Code
✅ .NET 6 o superior
✅ Conocimientos básicos de C#
✅ Postman o alguna herramienta para probar APIs

---

📁 Estructura típica de una API en ASP.NET Core

📦 MiApiProyecto
 ┣ 📁 Controllers
 ┣ 📁 Models
 ┣ 📁 Services (opcional)
 ┣ 📄 Program.cs
 ┣ 📄 appsettings.json

---

🛠️ Paso a paso para crear tu API

1️⃣ Crear un nuevo proyecto

En Visual Studio:
Archivo → Nuevo → Proyecto → API ASP.NET Core

Configura sin autenticación y con controladores (sin habilitar HTTPS si es para pruebas locales).

---

2️⃣ Crear tu primer modelo (ej. Producto)

public class Producto
{
    public int Id { get; set; }
    public string Nombre { get; set; }
    public decimal Precio { get; set; }
}

---

3️⃣ Crear un controlador

using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class ProductosController : ControllerBase
{
    private static List<Producto> productos = new List<Producto>
    {
        new Producto { Id = 1, Nombre = "Mouse", Precio = 250 },
        new Producto { Id = 2, Nombre = "Teclado", Precio = 500 }
    };

    [HttpGet]
    public IActionResult Get() => Ok(productos);

    [HttpGet("{id}")]
    public IActionResult GetById(int id)
    {
        var producto = productos.FirstOrDefault(p => p.Id == id);
        if (producto == null) return NotFound();
        return Ok(producto);
    }

    [HttpPost]
    public IActionResult Post([FromBody] Producto nuevo)
    {
        productos.Add(nuevo);
        return CreatedAtAction(nameof(GetById), new { id = nuevo.Id }, nuevo);
    }
}

---

🔍 Probar la API con Postman o Swagger

ASP.NET Core incluye Swagger por defecto.
Solo ejecuta tu proyecto y visita:
📍 https://localhost:5001/swagger

Ahí podrás probar los endpoints GET, POST, PUT y DELETE.

---

🧩 ¿Qué puedes agregar después?

• Conexión a base de datos con Entity Framework Core

• Autenticación con JWT

• Reglas de negocio con servicios (Service Layer)

• Inyección de dependencias

• Validaciones con Data Annotations o FluentValidation

• Logs y excepciones con Serilog

---

💡 Ventajas de usar ASP.NET Core para APIs

✅ Rápido y eficiente
✅ Soporte multiplataforma
✅ Estructura clara y escalable
✅ Ideal para microservicios
✅ Integración perfecta con frontend en Angular, React, Blazor, etc.

---

📘 Conclusión

Crear una API REST con ASP.NET Core es el primer paso para desarrollar sistemas modernos y conectados.
Desde microservicios hasta backends completos, el ecosistema .NET te ofrece todas las herramientas necesarias.

📌 Siguiente artículo:
👉 Entity Framework Core: ORM para Bases de Datos en .NET