asp.net-web-api-helppages - 帮助页面列出的重复 api

Question

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

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

GET api/v2/something/{id}

和

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

如何删除这些重复项？

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

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

Answer 1

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