Doc无法生成单个操作的多个操作

Question

我想知道是否有人在使用Swagger/ Swashbuckle 5.0.1记录单个操作时遇到了解决方法,该操作可能有多个操作.例如,请执行以下操作:

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

在尝试生成文档时,我收到错误,表明不支持此操作.但是,Swagger文档建议通过合并进行解决方法.

我不明白它们的含义以及如何去做.有人能提供任何信息吗？

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

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

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

Answer 1

如Swashbuckle SwaggerConfig.cs文件中关于此设置的所述：

与 WebApi 相比，Swagger 2.0 在映射 URL 时不包含查询字符串组件

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