swagger 如何屏蔽默认自带的接口？

Question

如下图，swagger 文档生成后总会默认生成一个 Swagger 接口，配置文件仔细研究了下，也没见屏蔽此接口的选项，

这个接口毫无用处，放这里影响观瞻，请问如何屏蔽这个自身接口？

Answer 1

1、SwaggerConfig.cs 文件中添加 DocumentFilter

GlobalConfiguration.Configuration.EnableSwagger(c =>{
    // 增加 DocumentFilter
    c.DocumentFilter<HiddenApiFilter>();  
})

2、增加HiddenApiFilter.cs类

[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class)]   
public partial class HiddenApiAttribute : Attribute { }
public class HiddenApiFilter : IDocumentFilter
{
   
    public void Apply(SwaggerDocument swaggerDoc, SchemaRegistry schemaRegistry, IApiExplorer apiExplorer)
    {
        foreach (ApiDescription apiDescription in apiExplorer.ApiDescriptions)
        {            
            var _key = "/" + apiDescription.RelativePath.TrimEnd('/');
            // 过滤 swagger 自带的接口
            if (_key.Contains("/api/Swagger") && swaggerDoc.paths.ContainsKey(_key))
                swaggerDoc.paths.Remove(_key);
        }
    }
}