swagger - swagger-ui 依赖于大响应

Question

我的一个端点返回一个 JSON（不大，大约 2MB）。尝试在此端点上运行 GETswagger-ui会导致浏览器挂起几分钟。在这段时间之后，它最终显示了 JSON。

有没有办法定义响应不应该被渲染，而是作为文件提供来下载？

我正在使用 OpenAPI 3，并尝试了以下操作：

content:
    application/json:
        schema:
            type: string
            format: binary

取自文档。尽管如此，swagger-ui 仍会呈现响应。

有没有人有同样的问题？

标签： swaggerswagger-uiopenapi

Answer 1

Lex45x在这个 github 问题中建议禁用语法突出显示。在 ASP.Net Core 中，您可以使用

app.UseSwaggerUI(config =>
{
    config.ConfigObject.AdditionalItems["syntaxHighlight"] = new Dictionary<string, object>
    {
        ["activated"] = false
    };
});

这显着提高了渲染性能。