NET 8 Multiple API Versions not working?

[TheMatrixDeveloper]

Hi,

I have the following simple minimal API setup in .NET 8, with Api Versioning enabled:

using Asp.Versioning;
using Asp.Versioning.Conventions;
using Scalar.AspNetCore;

namespace ApiVersioningScalar
{
	public class Program
	{
		public static void Main(string[] args)
		{
			var builder = WebApplication.CreateBuilder(args);

			builder.Services.AddApiVersioning(config =>
			{
				config.DefaultApiVersion = new(1, 0);
				config.ReportApiVersions = true;
				config.AssumeDefaultVersionWhenUnspecified = true;
				config.ApiVersionReader = ApiVersionReader.Combine(
					new UrlSegmentApiVersionReader(),
					new HeaderApiVersionReader("x-api-version"),
					new QueryStringApiVersionReader("api-version")
				);
			}).AddApiExplorer(config =>
			{
				config.GroupNameFormat = "v'VVV'";
				config.SubstituteApiVersionInUrl = true;
			});
			builder.Services.AddEndpointsApiExplorer();
			builder.Services.AddSwaggerGen();

			var app = builder.Build();

			// Configure the HTTP request pipeline.
			app.UseSwagger(options =>
			{
				options.RouteTemplate = "/openapi/{documentName}.json";
			});

			var apiVersionSet = app.NewApiVersionSet()
			.HasApiVersion(1, 0)
			.HasApiVersion(2, 0)
			.ReportApiVersions()
			.Build();

			app.MapScalarApiReference(config =>
			{
				config.AddDocuments(["v1", "v2"]);
			});

			app.MapGet("/test", (HttpContext httpContext) =>
			{
				return Results.Ok("V1 test");
			})
			.WithName("Test")
			.WithApiVersionSet(apiVersionSet)
			.MapToApiVersion(1, 0)
			.WithOpenApi();

			app.MapGet("/test", (HttpContext httpContext) =>
			{
				return Results.Ok("V2 test");
			})
			.WithName("/v2/Test")
			.WithApiVersionSet(apiVersionSet)
			.MapToApiVersion(2, 0)
			.WithOpenApi();

			app.Run();
		}
	}
}

When I run the project, I can see the dropdown on the top left corner:

But I do not see the corresponding endpoints for those versions.

What am I doing wrong ?

[xC0dex]

Hey @TheMatrixDeveloper,

You have to add one OpenAPI document per API version. More specific, calling builder.Services.AddSwaggerGen(); is not enough.

There are numerous blog posts out here like
https://markgossa.com/2022/05/asp-net-6-api-versioning-swagger.html or just watch this tutorial https://youtu.be/F9j3X6KuIpw?t=831. I think the video explains it pretty well 🙂.

[TheMatrixDeveloper]

Thnx XC0dex,

That was exactly what I was missing !