c# - 文档未能生成多个操作单个操作

Question

我想知道是否有人在使用 Swagger/Swashbuckle 5.0.1 来记录可以针对它执行多项操作的单个操作时遇到变通方法。例如，采用以下内容:

api/products
api/products?productType='cheese'

尝试生成文档时，我收到一条错误消息，提示这不受支持。然而，Swagger文档建议通过合并来解决。

我不明白他们的意思以及如何着手去做。谁能提供点资料？

我在他们的文档中找到的唯一解决方法是执行以下操作(使用第一个条目解决):

c.ResolveConflictingActions(x => x.First());

这并不理想，因为从 API 的角度来看，我希望所有变体都存在/可见。

Answer 1

如 Swashbuckle 所述 SwaggerConfig.cs此设置上的文件:

In contrast to WebApi, Swagger 2.0 does not include the query string component when mapping a URL

这不是 Web API 问题，Swagger 2.0 规范实际上不支持查询参数。