Start Debugging

タグ: openapi

6 件

2026-06-16 migration swashbuckle openapi

Swashbuckle から .NET 11 の組み込み OpenAPI ジェネレーターへ移行する

.NET 11 で Swashbuckle.AspNetCore から Microsoft.AspNetCore.OpenApi へのステップバイステップの移行: AddSwaggerGen を AddOpenApi に置き換え、操作・スキーマ・ドキュメントのフィルターをトランスフォーマーに変換し、UI を残し、噛みついてくる Microsoft.OpenApi v2 の破壊的変更を扱います。

2026-06-08 csharp dotnet dotnet-11

ASP.NET Core 11 で Swashbuckle なしに OpenAPI を公開する方法

Swashbuckle は ASP.NET Core のテンプレートから消えました。.NET 11 で組み込みパッケージ Microsoft.AspNetCore.OpenApi を使って OpenAPI ドキュメントを生成し提供する方法を解説します: AddOpenApi、MapOpenApi、トランスフォーマー、複数ドキュメント、ビルド時生成、その上に載せる UI。

2026-05-24 dotnet-11 aspnetcore openapi

.NET 11 Preview 4 の ASP.NET Core が OpenAPI に HTTP QUERY メソッドを教える

.NET 11 Preview 4 により、ASP.NET Core の OpenAPI 生成は HTTP QUERY を OpenAPI 3.2 の第一級の操作として認識するようになり、3.0 と 3.1 のドキュメントには適切なフォールバックが用意されます。

2026-04-28 dotnet-10 aspnetcore openapi

Asp.Versioning 10.0 がついに .NET 10 の組み込み OpenAPI とうまくかみ合う

Asp.Versioning 10.0 は .NET 10 と新しい Microsoft.AspNetCore.OpenApi パイプラインを対象とする最初のリリースです。4 月 23 日の Sander ten Brinke の解説では、WithDocumentPerVersion() を使って API バージョンごとに OpenAPI ドキュメントを 1 つずつ登録する方法を紹介しています。

2026-04-28 aspnetcore openapi swagger

.NET 11 で Swagger UI に OpenAPI 認証フローを追加する方法

.NET 11 では OpenAPI ドキュメントは Microsoft.AspNetCore.OpenApi が生成し、Swagger UI はテンプレートに含まれません。Bearer、PKCE 付き OAuth2、OpenID Connect を Authorize ボタンが実際に動くように接続する方法を解説します。

2026-04-24 dotnet dotnet-11 csharp

.NET 11 で OpenAPI 仕様から強く型付けされたクライアントコードを生成する方法

Microsoft 公式の OpenAPI コードジェネレーターである Kiota を使って、任意の OpenAPI 仕様から fluent で強く型付けされた C# クライアントを生成します。インストール、生成、ASP.NET Core DI への組み込み、認証設定まで順を追って解説します。