Do you use API Versioning to avoid breaking changes?

dotnet add package Asp.Versioning.Mvc

// Program.cs
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddApiVersioning(options =>
{
    options.DefaultApiVersion = new ApiVersion(1, 0);
    options.AssumeDefaultVersionWhenUnspecified = true;
    options.ReportApiVersions = true; // Adds api-supported-versions header
    options.ApiVersionReader = ApiVersionReader.Combine(
        new UrlSegmentApiVersionReader(),
        new HeaderApiVersionReader("X-Api-Version")
    );
})
.AddApiExplorer(options =>
{
    options.GroupNameFormat = "'v'VVV";
    options.SubstituteApiVersionInUrl = true;
});

[ApiController]
[Route("api/v{version:apiVersion}/[controller]")]
[ApiVersion("1.0")]
public class ProductsController : ControllerBase
{
    [HttpGet]
    public IActionResult GetAll() => Ok(new[] { new { Id = 1, Name = "Product" } });
}

[ApiController]
[Route("api/v{version:apiVersion}/[controller]")]
[ApiVersion("2.0")]
public class ProductsV2Controller : ControllerBase
{
    [HttpGet]
    public IActionResult GetAll() => Ok(new[] { new { Id = 1, Title = "Product", Sku = "ABC123" } });
}

GET /api/v1/products  → Returns { Id, Name }
GET /api/v2/products  → Returns { Id, Title, Sku }

// v1 - Original response
public class ProductV1
{
    public int Id { get; set; }
    public string Name { get; set; }
}

// v2 - Breaking change: Name renamed to Title, new required field
public class ProductV2
{
    public int Id { get; set; }
    public string Title { get; set; }  // Renamed from Name
    public string Sku { get; set; }    // New required field
}

[ApiController]
[Route("api/v{version:apiVersion}/products")]
[ApiVersion("1.0", Deprecated = true)]  // Mark as deprecated
[ApiVersion("2.0")]
public class ProductsController : ControllerBase
{
    [HttpGet]
    [MapToApiVersion("1.0")]
    public IActionResult GetV1()
    {
        Response.Headers.Append("Sunset", "Sat, 01 Jan 2025 00:00:00 GMT");
        Response.Headers.Append("Deprecation", "true");
        return Ok(GetProductsV1());
    }

    [HttpGet]
    [MapToApiVersion("2.0")]
    public IActionResult GetV2() => Ok(GetProductsV2());
}

builder.Services.AddSwaggerGen(options =>
{
    options.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
    options.SwaggerDoc("v2", new OpenApiInfo { Title = "My API", Version = "v2" });
});

app.UseSwagger();
app.UseSwaggerUI(options =>
{
    options.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
    options.SwaggerEndpoint("/swagger/v2/swagger.json", "My API V2");
});

// Track version usage for analytics
app.Use(async (context, next) =>
{
    var version = context.GetRequestedApiVersion();
    _telemetry.TrackEvent("ApiVersionUsed", new { Version = version?.ToString() });
    await next();
});