系统接口

官方文档 https://github.com/domaindrivendev/Swashbuckle.AspNetCore

默认系统接口访问地址：http://localhost:8888/swagger/index.html

关闭登录验证码

打开系统管理 -> 参数设置 -> 找到 验证码开关 -> 设置成 off

登录

授权 token

donate

注意

输入 token 的时候不要少了前面的Bearer 加空格

访问接口

donate

swagger 中隐藏接口

比如项目中有些接口不想在 swagger 中看到

[ApiExplorerSettings(IgnoreApi = true)]
public class PayController : BaseController
{

}

swagger 分组显示

// SwaggerExtension.cs

// 添加服务
builder.Services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("shopping", new OpenApiInfo
    {
        Title = "ZrAdmin.NET Api",
        Version = "v1",
        Description = "商城管理",
    });
});

app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("shopping/swagger.json", "商城管理");
    c.DocExpansion(DocExpansion.None); //->修改界面打开时自动折叠
});

...
-- 控制器/方法未正确应用特性
[ApiController]
[Route("api/[controller]")]
[ApiExplorerSettings(GroupName = "shopping")]
public class ProductsController : ControllerBase
{
    // 控制器方法...
}