API Versioning Strategy

Advanced

🌐 API Versioning Strategy

Versioning is critical for evolving APIs without breaking clients.

Install package:

dotnet add package Microsoft.AspNetCore.Mvc.Versioning

In Program.cs:

builder.Services.AddApiVersioning(opt =>
{
    opt.DefaultApiVersion = new ApiVersion(1, 0);
    opt.AssumeDefaultVersionWhenUnspecified = true;
    opt.ReportApiVersions = true;
    opt.ApiVersionReader = new UrlSegmentApiVersionReader();
});

In controller:

[ApiVersion("1.0")]
[Route("api/v{version:apiVersion}/products")]