c# - swagger-ui 中默认的 api 版本值

Question

我在我们的 asp.core wep-api 中配置了 swagger项目及其工作完美。现在我正在寻找解决方案 swagger-ui出现如下图所示

/image/WFVxw.jpg

api版本部分应该根据代码端的配置自动填充。

        services.AddSwaggerGen(c =>
        {
            c.SwaggerDoc("v1", new Info
            {
                Version = "v1",
                Title = "My API",
                Contact = new Contact
                {
                    Name = "My Api",
                    Url = "https://109.com/"
                }
            });
            var security = new Dictionary<string, IEnumerable<string>>
            {
                {"Bearer", new string[] { }},
            };
            c.AddSecurityDefinition("Bearer", new ApiKeyScheme
            {
                Description = "JWT Authorization header using the Bearer scheme. Example: \"Authorization: Bearer {token}\"",
                Name = "Authorization",
                In = "header",
                Type = "apiKey"
            });
            c.AddSecurityRequirement(security);
        });

Answer 1

您需要安装 Microsoft.AspNetCore.Mvc.Versioning 和 Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer 软件包才能在 Swagger 中启用 API 版本控制。

您可以在 here 查看更多详细信息.

在ConfigureServices方法中将版本控制方案定义为

 services.AddVersionedApiExplorer(o =>
 {
      o.GroupNameFormat = "'v'VVV";
      o.SubstituteApiVersionInUrl = true;
 });
 services.AddApiVersioning(config =>
 {
     config.DefaultApiVersion = new ApiVersion(1, 0);
     config.AssumeDefaultVersionWhenUnspecified = true;
     config.ReportApiVersions = true;
 });