Swagger Swashbuckle的4.0版在swagger页面顶部引入了一个新的大白条

Question

有人可以解释这个白条是什么吗？为什么里面什么都没有？如果应该包含某些内容，该如何添加？如果不需要它，我该如何摆脱它？在ASP.NET Core 2.1 WebAPI中使用Swashbuckle nuget软件包4.0.1。

这里是swagger.json的链接（我不能在这里直接添加，所以说代码太多了）

谢谢

ETA： 因此，在阅读完注释之后，有人将我指向了一张填写了方案的醒目的页面。我看着JSON并注意到了这一点：

我的没有这个。我将假设这是我的问题。如何使用swashbuckle插入此信息？

旁注：如果Swagger.JSON中不存在此信息...该白条是否应该简单地隐藏？

Answer 1

因此，顶部的大白条用于指定架构。如果您未明确指定架构，则该架构为空白。我已经在swagger的github存储库上打开了一个与此有关的问题。我相信，如果没有任何目的，该栏应该会消失。

要在此栏中添加有用的内容，您必须在项目中添加以下内容：

app.UseSwagger(c=>
{
    c.PreSerializeFilters.Add((swagger, httpReq) => swagger.Schemes = new[] { "http", "https" });
});

Answer 2

Swagger UI v 3.20.1中的空白白条was fixed。如果定义中没有schemes也没有securityDefinitions，则会出现白条。

Andy's workaround用于在{{1}中添加schemes和PreSerializeFilters，直到Swashbuckle将其捆绑的Swagger UI更新为包含该修补程序的版本为止。