Creación Rápida de una API RESTful en .NET Core

Introducción: En este tutorial, aprenderás a construir una API RESTful básica utilizando .NET Core en tan solo 10 minutos. Cubriremos la configuración inicial del proyecto, la definición de rutas y la implementación de métodos HTTP para operaciones CRUD (Crear, Leer, Actualizar, Eliminar).

Paso 1: Crear un nuevo proyecto ASP.NET Core Web API

Abre tu terminal y ejecuta el siguiente comando para crear un nuevo proyecto ASP.NET Core Web API:

dotnet new webapi -n MiApiRestful

Este comando creará un nuevo proyecto de API web con el nombre MiApiRestful.

Paso 2: Definir un modelo de datos

En este ejemplo, crearemos una API para gestionar una lista de tareas. Crea una clase Tarea en el archivo Tarea.cs dentro del proyecto con las siguientes propiedades:

public class Tarea
{
    public int Id { get; set; }
    public string Nombre { get; set; }
    public bool Completada { get; set; }
}

Paso 3: Configurar el enrutamiento de la API

Abre el archivo Program.cs y agrega el siguiente código para configurar el enrutamiento de la API:

builder.Services.AddControllers();

Paso 4: Implementar los controladores de la API

Crea un nuevo controlador llamado TareasController.cs dentro de la carpeta Controllers con el siguiente código:

using Microsoft.AspNetCore.Mvc;
using System.Collections.Generic;

[Route("api/[controller]")]
[ApiController]
public class TareasController : ControllerBase
{
    private static List<Tarea> tareas = new List<Tarea>
    {
        new Tarea { Id = 1, Nombre = "Completar tutorial", Completada = false },
        new Tarea { Id = 2, Nombre = "Preparar almuerzo", Completada = true }
    };

    [HttpGet]
    public ActionResult<List<Tarea>> ObtenerTodasLasTareas()
    {
        return Ok(tareas);
    }

    [HttpPost]
    public ActionResult<Tarea> AgregarTarea(Tarea nuevaTarea)
    {
        nuevaTarea.Id = tareas.Count + 1;
        tareas.Add(nuevaTarea);
        return CreatedAtAction(nameof(ObtenerTodasLasTareas), nuevaTarea);
    }

    [HttpPut("{id}")]
    public IActionResult ActualizarTarea(int id, Tarea tareaActualizada)
    {
        var tarea = tareas.Find(t => t.Id == id);
        if (tarea == null)
        {
            return NotFound();
        }

        tarea.Nombre = tareaActualizada.Nombre;
        tarea.Completada = tareaActualizada.Completada;
        return NoContent();
    }

    [HttpDelete("{id}")]
    public IActionResult EliminarTarea(int id)
    {
        var tarea = tareas.Find(t => t.Id == id);
        if (tarea == null)
        {
            return NotFound();
        }

        tareas.Remove(tarea);
        return NoContent();
    }
}

Este controlador define métodos para realizar operaciones CRUD en la lista de tareas.

Paso 5: Ejecutar la aplicación

Abre tu terminal, navega hasta la carpeta del proyecto y ejecuta el siguiente comando para iniciar la aplicación:

dotnet run

Paso 6: Probar la API

Usa una herramienta como Postman o cURL para enviar solicitudes HTTP a la API y probar las operaciones CRUD:

• GET /api/tareas: Obtener todas las tareas.
• POST /api/tareas: Agregar una nueva tarea.
• PUT /api/tareas/{id}: Actualizar una tarea existente.
• DELETE /api/tareas/{id}: Eliminar una tarea.

¡Y eso es todo! En solo 10 minutos, has creado una API RESTful básica utilizando .NET Core, incluyendo la configuración inicial, la definición de rutas y la implementación de métodos HTTP para operaciones CRUD.