ASP.NET Core Controller-basierte WebAPIs

Eintrag zuletzt aktualisiert am: 15.04.2026

Controller-basierte WebAPIs sind die ältere Form der Implementierung von WebAPIs mit ASP.NET Core.
Der klassische Ansatz basiert auf Klassen, Attributen und Routing-Konventionen.

Beispiel

[ApiController]
[Route("persons")]
public class PersonsController : ControllerBase
{
[HttpGet("{id}")]
public ActionResult<Person> Get(int id)
{
var person = Repository.Get(id);

if (person == null)
return NotFound();

return Ok(person);
}
}

Zusätzlich in Program.cs:

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();

Zentrale Unterschiede: ASP.NET Core Minimal WebAPIs vs. ASP.NET Core Controller-basierte WebAPIs

Minimal API
  • flach, funktional
  • alles oft in Program.cs oder wenigen Dateien
  • kompakter, direkter, weniger Struktur: kein Klassengerüst notwendig
  • gut für kleine Microservices / kleine bis mittlere APIs

Controller API
  • objektorientiert, strukturiert
  • klare Trennung in Controller, Services, Modelle
  • besser skalierbar bei großen Projekten / große Unternehmensanwendungen
  • gut bei vielen Endpunkten