Start Debugging

Тег: openapi

15 статей · Страница1из2

2026-08-19 errors swashbuckle openapi

Решение: не удаётся получить OpenAPI 3.0 после обновления Swashbuckle.AspNetCore до v9

Swashbuckle 8 и новее выдают openapi 3.0.4, а не 3.0.1, и значения OpenApiSpecVersion для patch-версии не существует. Почему так вышло и четыре способа зафиксировать нужную строку.

2026-08-19 errors openapi swagger

Исправление: Swagger UI показывает Unable to render this definition после обновления до .NET 11

ASP.NET Core 11 по умолчанию выдаёт openapi 3.2.0, а Swagger UI ниже 10.1.5 его отвергает. Обновите Swashbuckle.AspNetCore.SwaggerUI или зафиксируйте OpenApiVersion на OpenApi3_1.

2026-08-15 comparison csharp dotnet

Scalar против Swagger UI для документации OpenAPI в ASP.NET Core 11

Scalar отдаёт 1.02 МиБ сжатого gzip JavaScript и заметно более удобный конструктор запросов. Swagger UI отдаёт 514 КиБ и рендерит OpenAPI 3.2, который .NET 11 теперь генерирует по умолчанию. Измеренные объёмы, разрыв по 3.2, маршрутизация через конечные точки с обеих сторон и детали аутентификации, которые решают выбор.

2026-08-12 errors aspnetcore dotnet

Исправление: The 'interceptors' feature is not enabled in this namespace

CS9137 приходит от генератора исходного кода в Microsoft.AspNetCore.OpenApi. Добавьте InterceptorsNamespaces в каждый проект, который вызывает AddOpenApi, а не только в тот, где лежит PackageReference.

2026-08-11 errors aspnetcore dotnet

Решение: The type or namespace name 'OpenApiReference' could not be found

OpenApiReference удалён в Microsoft.OpenApi 2.0. Смены using на Microsoft.OpenApi недостаточно: замените каждое использование типизированной ссылкой вроде OpenApiSchemaReference.

2026-08-09 csharp dotnet dotnet-11

Как отдавать документацию OpenAPI через Scalar вместо Swagger UI в ASP.NET Core 11

Замените UseSwaggerUI на MapScalarApiReference в ASP.NET Core 11: маршрутизация, несколько документов, предзаполненная аутентификация, защита в продакшене, ресурсы без CDN и расширения OpenAPI, доступные только в Scalar.

2026-07-24 migration swashbuckle openapi

Миграция Swashbuckle IOperationFilter и ISchemaFilter на трансформеры OpenAPI в .NET 11

Пофильтровый справочник по миграции для перевода кода IOperationFilter и ISchemaFilter из Swashbuckle на встроенные трансформеры операций и схем в .NET 11, с сопоставлением объектов контекста и изменениями Microsoft.OpenApi v2, которые ломают компиляцию.

2026-07-14 csharp dotnet dotnet-11

Как вернуть типизированное объединение Results<T1, T2> из эндпоинта minimal API в ASP.NET Core 11

Объявите тип возврата обработчика как Results<Ok<T>, NotFound> и возвращайте TypedResults.Ok / TypedResults.NotFound: объединение даёт проверку на этапе компиляции того, что обработчик возвращает только то, что объявляет, и само описывает себя для OpenAPI, так что вам никогда не придётся писать .Produces вручную. Рассматриваются асинхронные обработчики, ограничение в шесть типов и тестирование в ASP.NET Core 11.

2026-07-12 csharp dotnet dotnet-11

Как настроить документ OpenAPI с помощью AddOperationTransformer и AddSchemaTransformer в ASP.NET Core 11

Подробный разбор встроенного конвейера трансформеров OpenAPI в .NET 11: трансформеры операций и схем, объекты контекста, порядок выполнения, трансформеры, активируемые через DI, а также рецепты для заголовков, ответов, примеров и точечных изменений свойств.

2026-06-16 migration swashbuckle openapi

Миграция со Swashbuckle на встроенный генератор OpenAPI в .NET 11

Пошаговая миграция со Swashbuckle.AspNetCore на Microsoft.AspNetCore.OpenApi в .NET 11: замена AddSwaggerGen на AddOpenApi, преобразование фильтров операций, схем и документа в трансформеры, сохранение UI и несовместимые изменения Microsoft.OpenApi v2, которые кусаются.