c# - 获取 Swasbuckle 5 以输出 Swagger 2.0 Json 而不是 OpenAPI 3.0

Question

我已将我的 Swashbuckle 升级到版本 5，一切都好多了。

现在我遇到一个问题，我的消费者需要 Swagger Json 格式作为 Swagger 2.0，而不是 Swashbuckle 5 中以 Openapi 3.0.1 格式输出 swagger 的默认格式。

我的配置如下:

    public static void ConfigureSwagger(SwaggerGenOptions c)
    {
        c.SwaggerDoc("v1", new OpenApiInfo
        {
            Title = "Gdpr Api",
            Version = "v1",
            Description ="This API is for GDPR ."
        });
        c.EnableAnnotations();
    }

    public static void ConfigureSwaggerUi(this IApplicationBuilder app)
    {
        app.UseSwagger();
        app.UseSwaggerUI(c =>
        {
            c.SwaggerEndpoint("/swagger/v1/swagger.json", "GDPR - Version 1");
            c.DocumentTitle = "Gdpr Swagger";
        });
    }

Answer 1

我认为这是不可能的，直到我发现您可以在 Helen 和 Release Notes for RC4 的帮助下执行以下操作.解决方案是设置 SerializeAsV2 = true。

    public static void ConfigureSwaggerUi(this IApplicationBuilder app)
    {
        app.UseSwagger(p => p.SerializeAsV2 = true);
        app.UseSwaggerUI(c =>
        {
            c.SwaggerEndpoint("/swagger/v1/swagger.json", "GDPR - Version 1");
            c.DocumentTitle = "Gdpr Swagger";
        });
    }

这将以 2.0 格式输出 Swagger JSON。