1. ¿Qué es Carter y por qué usarlo?

Carter es un framework ligero y de alto rendimiento para crear APIs HTTP en ASP.NET Core. Inspirado en el popular framework NancyFX, ofrece a los desarrolladores un enfoque declarativo y familiar para el enrutamiento y manejo de solicitudes. A diferencia del MVC tradicional (Model-View-Controller), Carter permite definir endpoints directamente en el código, sin necesidad de crear controladores separados ni configurar enrutamiento complejo.

¿Por qué usar Carter? La razón principal es la simplicidad y velocidad de desarrollo. Si necesitas crear rápidamente una API mínima o un microservicio, Carter proporciona una sintaxis concisa que reduce el código repetitivo. Es ideal para proyectos que no requieren toda la potencia de MVC, pero sí flexibilidad y facilidad para trabajar con solicitudes y respuestas. Además, Carter se integra perfectamente con ASP.NET Core, utilizando su contenedor de dependencias incorporado, middleware y otras funcionalidades.

Las características clave de Carter incluyen: enlace automático de parámetros de ruta y cuerpo de solicitud (model binding), soporte integrado para validación, manejo simple de errores y la posibilidad de probar endpoints fácilmente. El framework cuenta con una comunidad activa y se utiliza en entornos de producción por muchas empresas.

2. Instalación

Para instalar Carter en tu proyecto ASP.NET Core, usa el administrador de paquetes NuGet. Ejecuta uno de los siguientes comandos en la terminal:

dotnet add package Carter

o a través de la consola del administrador de paquetes de Visual Studio:

Install-Package Carter

Después de la instalación, debes registrar Carter en tu archivo Program.cs (o Startup.cs en versiones anteriores):

using Carter;

var builder = WebApplication.CreateBuilder(args);

// Agregamos Carter al contenedor DI
builder.Services.AddCarter();

var app = builder.Build();

// Conectamos el middleware de Carter
app.MapCarter();

app.Run();

Nota: en versiones modernas de .NET (6+) se usa la API mínima, pero Carter sigue siendo relevante para lógica más compleja.

3. Inicio rápido — ejemplo mínimo funcional

Crea un nuevo proyecto ASP.NET Core (vacío o Web API). Instala Carter como se describió anteriormente. Luego, crea una clase que implemente la interfaz ICarterModule:

using Carter;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Routing;

public class HomeModule : ICarterModule
{
    public void AddRoutes(IEndpointRouteBuilder app)
    {
        // Definimos un endpoint GET en la ruta "/"
        app.MapGet("/", () => "¡Hola desde Carter!");
        
        // Definimos un endpoint GET con un parámetro
        app.MapGet("/hello/{name}", (string name) => $"¡Hola, {name}!");
    }
}

Ahora registra este módulo en Program.cs:

using Carter;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddCarter();
var app = builder.Build();
app.MapCarter();
app.Run();

Ejecuta la aplicación y navega a http://localhost:5000/hello/Mundo. Verás la respuesta: ¡Hola, Mundo!.

4. Métodos/funciones/clases principales

Veamos los elementos clave de Carter que usarás con más frecuencia.

4.1. ICarterModule

ICarterModule es la interfaz principal que debes implementar para definir tus endpoints. Cada módulo agrupa rutas relacionadas, lo que facilita la organización del código. El método AddRoutes recibe un objeto IEndpointRouteBuilder donde puedes definir tus rutas usando métodos como MapGet, MapPost, MapPut, MapDelete, etc.