OpenApiVersion ma domyślną wartość OpenApi3_2

Wartość domyślna zmiennej została zmieniona OpenApiVersion z OpenApiSpecVersion.OpenApi3_1 na OpenApiSpecVersion.OpenApi3_2. Aplikacje, które zależą od danych wyjściowych interfejsu OpenAPI 3.1 bez jawnego ustawiania wersji, generują teraz dokumenty openAPI 3.2.

Wersja wprowadzona

.NET 11 (wersja zapoznawcza 6)

Poprzednie zachowanie

OpenApiOptions.OpenApiVersion Wcześniej wartość domyślna to OpenApiSpecVersion.OpenApi3_1. Wywoływanie AddOpenApi bez jawnego ustawiania wersji wygenerowało dokument OpenAPI 3.1.

Nowe zachowanie

Począwszy od wersji ASP.NET Core 11 (wersja zapoznawcza 6), OpenApiOptions.OpenApiVersion wartość domyślna to OpenApiSpecVersion.OpenApi3_2. Wywoływanie AddOpenApi bez jawnego ustawienia wersji powoduje teraz utworzenie dokumentu OpenAPI 3.2.

Typ zmiany przełamującej

Ta zmiana jest zmianą behawioralną.

Przyczyna zmiany

Obsługa OpenAPI w platformie ASP.NET Core domyślnie korzysta z najnowszej opublikowanej wersji specyfikacji OpenAPI, dzięki czemu aplikacje mogą korzystać z nowych możliwości bez dodatkowej konfiguracji.

Zalecana akcja

W większości przypadków nie jest wymagana żadna akcja. Aby obsługiwać narzędzia podrzędne, które nie obsługują jeszcze interfejsu OpenAPI 3.2, skonfiguruj jawnie wersję:

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

Interfejsy API, których dotyczy problem

• OpenApiVersion