帮助页面列出的重复API

Question

我正在使用Microsoft的webapi帮助页面nuget包。

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

GET api/v2/something/{id}

和

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

如何删除这些副本？

令人惊讶的是，我去年增加了一些没有发生的旧控制器。

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

Answer 1

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