How to version Web APIs (URL versioning, header versioning,
Short answer: media type versioning) Use Microsoft.AspNetCore.Mvc.Versioning package. ✅ Supported methods: URL versioning: /api/v1/products Header versioning: X-API-Version: 1.0 Media Type versioning: Accept: application/vnd.company.v1+json services.AddApiVersioning(options => { options.ReportApiVersions = true;
Example code
options.AssumeDefaultVersionWhenUnspecified = true;
options.DefaultApiVersion = new ApiVersion(1, 0); });
Real-world example (ShopNest)
A ShopNest checkout request flows through middleware, hits a minimal API or controller, uses scoped services, and returns ProblemDetails on errors.
Say this in the interview
- Define — one clear sentence (the short answer above).
- Example — relate it to a project like ShopNest or your real work.
- Trade-off — when you would not use it.
Share this Q&A
Share preview image: https://www.toolliyo.com/images/toolliyo-logo.png