.net Swagger

一、swagger使用

1.打開Nuget，搜索安裝Swashbuckle.AspNetCore。

2.生成api文檔

 3.Program.cs 添加如下代碼 FreightForwarderApi.xml  替換成你的。

var basePath = AppContext.BaseDirectory;





builder.Services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo
    {
        Version = "v1",
        Title = "Api"
    });

    var xmlPath = Path.Combine(basePath, "FreightForwarderApi.xml");
    c.IncludeXmlComments(xmlPath, true);
    //var xmlDomainPath = Path.Combine(basePath, "NET6.Domain.xml");
    //c.IncludeXmlComments(xmlDomainPath, true);
    c.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme
    {
        Description = "Value: Bearer {token}",
        Name = "Authorization",
        In = ParameterLocation.Header,
        Type = SecuritySchemeType.ApiKey,
        Scheme = "Bearer"
    });
    c.AddSecurityRequirement(new OpenApiSecurityRequirement()
    {
      {
        new OpenApiSecurityScheme
        {
          Reference = new OpenApiReference
          {
            Type = ReferenceType.SecurityScheme,
            Id = "Bearer"
          },Scheme = "oauth2",Name = "Bearer",In = ParameterLocation.Header,
        },new List<string>()
      }
    });
});

4.運行後就有了

5.新增控制器，增加接口顯示。增加基類

6.其他控制器，基於該類

運行如下：

 

 

 

https://blog.csdn.net/mengke2815/article/details/122408876?spm=1001.2014.3001.5502