帮助页面列出的重复 API

Question

我使用的是来自Microsoft的webapi帮助页面nuget包。

当我最近添加了一个新的控制器时，我在帮助页面中的所有路线都会出现两次：

GET api/v2/something/{id}

和

GET api/v2/something?id={id}

如何删除这些重复项？

令人惊讶的是，对于我去年添加的一些老控制器来说，这种情况并没有发生。

我能想到的唯一区别是，在新控制器中，我使用dynamic作为响应类型，但我也使用ResponseTypeAttribute，因此在帮助页面中，DTO模型可以正确显示。

Answer 1

我建议您使用Swagger/Swashbull，而不是WebAPI帮助页。你可以通过nuget安装它。它将在App_Start文件夹中创建SwaggerConfig.cs。根据您的需求，可能需要进行一些小的调整。只需查看文档即可。