Start Debugging

Тег: openapi

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

2026-10-20 aspnetcore openapi dotnet-11

Как пометить ответ действия контроллера как допускающий null во встроенном документе OpenAPI в ASP.NET Core

Microsoft.AspNetCore.OpenApi помечает ответ как допускающий null, только когда действие возвращает голый T? (а в .NET 10 не помечает даже Task<T?>). ActionResult<T?> и IActionResult теряют аннотацию и в .NET 10, и в .NET 11 RC2. Здесь разобрано, почему так происходит, показан проверенный трансформер операций, который это исправляет, и ловушка с 204 No Content, из-за которой спецификация лжёт, пока вы не измените форматтер MVC.

2026-10-17 aspnetcore aspnetcore-11 identity

Как удалить или скрыть отдельные endpoint, которые MapIdentityApi добавляет в ASP.NET Core

MapIdentityApi<TUser>() добавляет десять endpoint и не позволяет пропустить ни один из них. Вот четыре проверенных способа справиться с этим на .NET 11: скрыть endpoint из OpenAPI, заставить его возвращать 404, перекрыть его или полностью убрать из маршрутизации, плюс ловушка /confirmEmail, из-за которой регистрация превращается в 500.

2026-09-11 csharp csharp-15 dotnet-11

Юнионы C# в ASP.NET Core 11: тела запросов, SignalR и OpenAPI работают, query string нет

Команда ASP.NET Core описала, где типы union из C# 15 работают в .NET 11: тела запросов в minimal API и MVC, JsonHubProtocol в SignalR, Blazor и схемы anyOf в OpenAPI. Привязка из маршрута, query, заголовков и форм пока не поддерживается.

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, которые ломают компиляцию.