OpenApiVersion tem como padrão OpenApi3_2

O valor padrão de OpenApiVersion foi alterado de OpenApiSpecVersion.OpenApi3_1 para OpenApiSpecVersion.OpenApi3_2. Aplicativos que dependem da saída do OpenAPI 3.1 sem definir explicitamente a versão agora produzem documentos OpenAPI 3.2.

Versão introduzida

.NET 11 Versão Prévia 6

Comportamento anterior

Anteriormente, OpenApiOptions.OpenApiVersion era definido por padrão como OpenApiSpecVersion.OpenApi3_1. Chamar AddOpenApi sem definir explicitamente uma versão produziu um documento OpenAPI 3.1.

Novo comportamento

A partir do ASP.NET Core 11 Preview 6, OpenApiOptions.OpenApiVersion passa a ser o padrão de OpenApiSpecVersion.OpenApi3_2. Chamar AddOpenApi sem definir explicitamente uma versão agora produz um documento OpenAPI 3.2.

Tipo de mudança disruptiva

Esta é uma alteração comportamental.

Motivo da alteração

O suporte ao OpenAPI do ASP.NET Core usa a versão mais recente lançada da especificação OpenAPI como padrão para que os aplicativos se beneficiem de novos recursos sem configuração adicional.

Ação recomendada

Na maioria dos casos, nenhuma ação é necessária. Para dar suporte a ferramentas downstream que ainda não manipulam o OpenAPI 3.2, configure a versão explicitamente:

builder.Services.AddOpenApi(options =>
{
    options.OpenApiVersion = Microsoft.OpenApi.OpenApiSpecVersion.OpenApi3_1;
});

APIs afetadas

• OpenApiVersion