なぜSwaggerなのか

元々typescript+expressで地道に作成していたWebAPIのソースコードが肥大化してきて管理がしづらくなってきたのでSwaggerのyamlで管理しようと考えたのが始まりです。

APIドキュメントも作成できるのでパッと見でどんなAPIがあるのかわかりやすくなる利点もあります。
~~Request,Response用のクラスを作るのが面倒だったわけでは決してありません。。。~~

コードを出力してみる

左側のyamlファイルを入力してから[Generate Server] → [aspnetcore]を選択すると
ソースコード一式がダウンロードされます。

[aspnetcore-server-generated.zip]というファイルを解凍すると[IO.Swagger.sln]があるのでそちらをクリックしてvisual studioを起動します。

■Visual Studio 2022 Communityは無料で使えます
https://visualstudio.microsoft.com/ja/vs/community/

プロジェクトファイルのプロパティを見てみると、.Net Core 3.1となっています。

このターゲットフレームワークを.Net 7.0に変更します。

というわけなのでSwashbuckleもバージョンを上げてしまいましょう。
NuGet → 更新プログラムからまとめて更新します。

途中で出てくるダイアログは全部OKで！

swagger.yamlの記述に問題なければこれで問題なく起動できるはずです。

ただ、同じ手順で会社のPCで試した時は問題なく起動したので
自PCの問題かもしれません。

起動してSwagger UIが表示された皆さんはおめでとうございます。

どうも50352ポートが使用されているとメッセージが出てくるんですけど
調べても使ってないし、task killしても引き続きエラーになります。

雑な方法ですが、launchSettings.jsonを書き換えます。

8080とかに書き換えましたが他のアプリケーションと被らないポートを設定してください。

このあと一応リビルドかけてVisual Studioをいったん閉じて開き直します。

Startuo.csで下記の様なエラーになる場合はTermsOfServiceの行をコメントアウトすればエラーにならなくなります。swagger.yamlでキチンと定義してあれば問題ないはず。