如何使用 NSwag 生成 OpenAPI 2.0 文件？

Question

我正在使用 NSwag 并尝试将 OpenAPI JSON 文档转换为版本 2。这是我的配置：

public void ConfigureServices(IServiceCollection services)
{
            services.AddControllers();

            services.AddOpenApiDocument(config =>
            {
                config.PostProcess = doc =>
                {
                    doc.SchemaType = NJsonSchema.SchemaType.Swagger2;
                }
            }
}

但是，当我将生成的 OpenAPI 文件粘贴到 Swagger Editor 时，它显示错误：

如何配置 NSwag 以生成正确的 OpenAPI 2.0 文件？

Answer 1

要将 NSwag 配置为输出 OpenAPI 2.0 定义而不是 OpenAPI 3.0，请使用 .AddSwaggerDocument(...) 而不是 .AddOpenAPIDocument(...)。更多信息：

https://github.com/RicoSuter/NSwag/wiki/AspNetCore-Middleware

如何使用 NSwag 生成 OpenAPI 2.0 文件？

How to generate an OpenAPI 2.0 file with NSwag?

swagger

openapi

nswag