帮助页面列出的重复 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。根据您的要求，您可能需要进行一些小的调整。只需检查文档即可。