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

时间:2015-03-03 18:10:06

标签: c# asp.net-web-api swagger

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

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

尝试生成文档时,我收到错误提示不支持此操作。但是,Swagger文档表明通过合并有一种解决方法。

我不明白这是什么意思,以及如何去做。任何人都可以提供任何信息吗?

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

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

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

1 个答案:

答案 0 :(得分:1)

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

  

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

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