Как сгенерировать файл OpenAPI 2.0 с помощью NSwag?

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, он показывает ошибки:

Как настроить NSwag для создания правильного файла OpenAPI 2.0?

Answer 1

Чтобы настроить NSwag для вывода определения OpenAPI 2.0 вместо OpenAPI 3.0, используйте .AddSwaggerDocument(...) вместо .AddOpenAPIDocument(...). Подробнее:

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