SwaggerUIとSwashbuckleは多型/派生型を認識します

Question

C＃とWebAPIを使用してRest APIを作成しています。私はSwagger UIをAPIに追加し、AutoRestを使ってクライアントを生成するためにSwashbuckleを使用しています。これは私のモデルに多型性/継承を導入するまで、すべて正常に機能します。 Swagger UIは、基本クラスの定義を作成するだけであり、その結果、私のAutoRestクライアントはインタフェース内に基本タイプしか持たない。

Swashbuckle/Swaggerに派生型を認識させるために、モデルに必要な属性はありますか？

Answer 1

Swagger/OpenAPI仕様は多型をサポートしています。 Swashbuckle versions feature comparision上に述べたように、動的に闊歩ドキュメントを生成

SwashBuckleは、バージョン5.0 から多型をサポートしていません。

多態性を扱う唯一の方法は、modify generated definitionsへのIDocumentFilterインターフェイスを使用して、スワッガーモデルが完全に生成された後に独自のコードを作成することです。