d1-03-swagger について
ASP.NET Core API に Swagger UI を設定するスキルです。既存の OpenAPI 設定を確認し、UI が必要な場合に Swashbuckle を追加する方法を示します。
主な機能
- 01既存の OpenAPI 設定の確認
- 02Swashbuckle パッケージの追加
- 03Swagger UI の設定
活用シーン
- 01インタラクティブな API ドキュメントの公開
- 02ASP.NET Core API への Swagger UI の追加
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/d1-03-swaggerを入力して読み込まれたか確認します。
詳細
1日目・ステップ 3 — Swagger
まず up-api/Program.cs を確認してください。最近の dotnet new webapi テンプレートでは、OpenAPI がすでにスキャフォールディングされています
（AddOpenApi() / MapOpenApi()）。生の OpenAPI JSON だけでなく、Swagger UI が必要な場合は、Swashbuckle を追加してください。
cd up-api
dotnet add package Swashbuckle.AspNetCore
Program.cs に追加します。
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
// ...
app.UseSwagger();
app.UseSwaggerUI();
コメント
Markdown 対応