Start Debugging

Тег: openapi

10 статей

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, которые кусаются.

2026-06-08 csharp dotnet dotnet-11

Как отдать OpenAPI без Swashbuckle в ASP.NET Core 11

Swashbuckle исчез из шаблонов ASP.NET Core. Вот как сгенерировать и отдать документ OpenAPI в .NET 11 со встроенным пакетом Microsoft.AspNetCore.OpenApi: AddOpenApi, MapOpenApi, трансформеры, несколько документов, генерация во время сборки и интерфейс поверх.

2026-05-24 dotnet-11 aspnetcore openapi

ASP.NET Core в .NET 11 Preview 4 обучает OpenAPI методу HTTP QUERY

.NET 11 Preview 4 заставляет генерацию OpenAPI в ASP.NET Core распознавать HTTP QUERY как полноценную операцию в OpenAPI 3.2, с аккуратным запасным вариантом для документов 3.0 и 3.1.

2026-04-28 dotnet-10 aspnetcore openapi

Asp.Versioning 10.0 наконец-то дружит со встроенным OpenAPI в .NET 10

Asp.Versioning 10.0 — это первый релиз, нацеленный на .NET 10 и новый пайплайн Microsoft.AspNetCore.OpenApi. Руководство Сандера тен Бринке от 23 апреля показывает, как зарегистрировать отдельный документ OpenAPI на каждую версию API с помощью WithDocumentPerVersion().

2026-04-28 aspnetcore openapi swagger

Как добавить потоки аутентификации OpenAPI в Swagger UI на .NET 11

В .NET 11 документ OpenAPI генерирует Microsoft.AspNetCore.OpenApi, а Swagger UI больше не входит в шаблон. Разбор того, как подключить Bearer, OAuth2 с PKCE и OpenID Connect, чтобы кнопка Authorize действительно работала.

2026-04-24 dotnet dotnet-11 csharp

Как генерировать строго типизированный клиентский код из спецификации OpenAPI в .NET 11

Используйте Kiota, официальный генератор OpenAPI от Microsoft, для создания fluent-клиента на C# со строгой типизацией из любой спецификации OpenAPI. Пошагово: установка, генерация, подключение к DI в ASP.NET Core и настройка аутентификации.