SwaggerUI 通过 Swashbuckle 记录了针对 1 ASP.NET WEB API 操作的两种不同模型

Question

我有一个场景，我的 ASP.NET WEB API returns 2 个不同的模型取决于请求对象。我正在使用 swagger UI（通过 swashbuckle）来记录我的 ASP.NET WEB API，目前无法找到一种方法来针对 1 ASP.NET WEB [= 记录这两个模型17=] 行动。 我试过谷歌搜索但没有结果。任何帮助将不胜感激。

Answer 1

OpenAPI（以前称为 Swagger）规范版本 2 没有任何方法来描述同一操作的两个不同模型。使用新的 OpenAPI V3，您可以使用具有 oneOf 属性的架构来描述多个可能的响应形状。

但是，V3 可用的工具不多。