Minimal APIs vs Controllers: quando cada um faz sentido

Minimal APIs no ASP.NET Core não substituem controllers — elas encolhem a superfície quando o endpoint é pequeno e estável.

Quando minimal faz sentido

• —Endpoints de leitura simples (health, config, webhooks).
• —Microserviços com poucas rotas e time pequeno.
• —Prototipagem rápida sem camada MVC completa.

app.MapGet("/health", () => Results.Ok(new { status = "ok" }));

Quando preferir controllers

Controllers ainda ganham quando você precisa de filtros complexos, versionamento explícito, muitos DTOs ou testes de integração que mapeiam actions nomeadas. Minimal APIs empurram tudo para um arquivo — ótimo no início, ruim quando viram “god endpoint”.

Regra prática: comece minimal se couber em uma tela; migre para controller quando adicionar validação, auth policies e testes começar a doer.