.NET中的Swagger使用示例详解

builder.Services.AddSwaggerGen(options =>
{
    //诸如作者、文档说明的信息
    options.SwaggerDoc("v1", new OpenApiInfo
    {
        Version = "v1",
        Title = "我的API",
        Description = "这是我的netcoreAPI项目",//描述信息
        Contact = new OpenApiContact
        {
            Name = "我是小小鱼",
            Url = new Uri("https://blog.csdn.net/qq_42335551")
        }
    });

 app.UseSwagger();
    app.UseSwaggerUI(c => { 
        c.DocumentTitle = "后台接口列表";   //标签页标题
        c.SwaggerEndpoint("/swagger/v1/swagger.json", "公共模块");//接口文档json文件
        c.RoutePrefix =string.Empty;// 注:这里的路由修改后，launchSettings.json中的launchUrl对应需要调整为""
    });

<GenerateDocumentationFile>true</GenerateDocumentationFile>

builder.Services.AddSwaggerGen(options =>
{
    //诸如作者、文档说明的信息
    options.SwaggerDoc("v1", new OpenApiInfo
    {
        Version = "v1",
        Title = "我的API",
        Description = "这是我的netcoreAPI项目",//描述信息
        Contact = new OpenApiContact
        {
            Name = "我是小小鱼",
            Url = new Uri("https://blog.csdn.net/qq_42335551")
        }
    });
    var xmlFilename = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
    options.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, xmlFilename), true);//true 显示控制器注释
});

    options.SwaggerDoc("yw", new OpenApiInfo { Title = "业务模块", Version = "yw" });
    options.SwaggerDoc("qt", new OpenApiInfo { Title = "其他模块", Version = "qt" });

 c.SwaggerEndpoint("/swagger/v1/swagger.json", "公共模块");//接口文档json文件
 c.SwaggerEndpoint("/swagger/yw/swagger.json", "业务模块");
 c.SwaggerEndpoint("/swagger/qt/swagger.json", "其他模块");
 c.DocExpansion(Swashbuckle.AspNetCore.SwaggerUI.DocExpansion.List);//接口不展开None