#api-design

Articles tagged with #api-design

Long-Running Operations in ASP.NET Core APIs: Enterprise Decision Guide
Every enterprise API team eventually builds an endpoint that does too much — a report that takes 30 seconds, an image processing pipeline, a batch job triggered by an external system. Synchronous HTTP
May 20, 202612 min read
API Response Standardization in ASP.NET Core: Problem Details vs Custom Envelope vs Minimal Wrapper — Enterprise Decision Guide
Every ASP.NET Core team eventually faces the same question: how should our API communicate with its consumers? Not just when something goes wrong — but in every response, success or failure. The decis
May 2, 202612 min read7
Partial Resource Updates in ASP.NET Core: JSON Patch vs Nullable DTO vs Custom Update Strategy — Enterprise Decision Guide
Partial resource updates are one of the most quietly contentious design decisions in ASP.NET Core API development. Every team hits the question eventually: a client sends a PATCH request to update two
Apr 28, 202613 min read10
Content Negotiation in ASP.NET Core: JSON vs XML vs MessagePack vs Custom Formatters — Enterprise Decision Guide
Content negotiation in ASP.NET Core is one of those features that most teams leave on default until a client integration forces the conversation. The framework defaults to JSON — and for the vast majo
Apr 19, 202610 min read6
FastEndpoints vs Controllers vs Minimal APIs in .NET: Which Should Your Team Use?
Choosing how to structure your ASP.NET Core API layer is one of those decisions that follows your team for years. Pick the wrong model, and you're either wrestling with unnecessary complexity on a thr
Apr 11, 202610 min read24
ASP.NET Core Model Binding Sources: [FromBody] vs [FromQuery] vs [FromRoute] — Enterprise Decision Guide
ASP.NET Core's model binding system is one of the framework's most powerful — and most misused — features. Every enterprise API team eventually faces the same set of decisions: when to use [FromBody],
Apr 2, 202612 min read9