SwaggerUI 和 Swashbuckle 识别多态/派生类型

Question

我正在使用 C# 和 WebAPI 创建一个 Rest API。我正在使用 Swashbuckle 将 Swagger UI 添加到 API 和 AutoRest 以生成客户端。这一切都很好，直到我将多态性/继承引入我的模型。 Swagger UI 只是为基类创建定义，这导致我的 AutoRest 客户端在接口中只有基类型。

我的模型是否需要属性以允许 Swashbuckle / Swagger 识别派生类型？

Answer 1

Swagger / OpenAPI 规范确实支持多态性。

SwashBuckle，如Swashbuckle versions feature comparision 所述，动态生成 Swagger 文档，不支持版本 5.0 的多态性。

您可以在这里处理多态性的唯一方法是在完全生成 Swagger 模型后构建您自己的代码，使用 IDocumentFilter 到 modify generated definitions 的接口。