asp.net-web-api-helppages - ヘルプ ページにリストされている API の重複

Question

Microsoft の webapi ヘルプ ページ nuget パッケージを使用しています。

最近新しいコントローラーを追加したとき、ヘルプ ページのすべてのルートが 2 回表示されます。

GET api/v2/something/{id}

と

GET api/v2/something?id={id}

これらの重複を削除するにはどうすればよいですか?

驚いたことに、昨年追加したいくつかの古いコントローラーでは、それは起こりませんでした。

私が考えることができる唯一の違いは、新しいコントローラーdynamicで応答タイプとして使用したResponseTypeAttributeことですが、ヘルプページでもDTOモデルが正しく表示されるように使用しました。

Answer 1

WebAPI ヘルプ ページの代わりに Swagger/Swashbuckle を使用することをお勧めします。ナゲット経由でインストールできます。App_Start フォルダーに SwaggerConfig.cs が作成されます。要件に応じて、いくつかの微調整が必​​要になる場合があります。ドキュメントを確認してください。