.net - Web API 帮助页面显示每个方法的两个版本

Question

如何避免帮助页面显示我的方法的两个版本？

如您所见，我已经为 /api/property/search/{finnId} 设置了自定义路由，但我不希望使用查询参数的路由出现在帮助页面。有办法解决这个问题吗？我正在使用 ASP.NET Fall 2012 BUILD 预览版中的内置帮助页面。

顺便说一句，不用担心它显示的是 POST，我已经将其切换为 GET，但我得到了相同的结果。

Answer 1

如果您只是想在“帮助”页面中隐藏此路线，而不是在应用程序中实际禁用它，则可以随时调整显示模板中的逻辑。

您可以通过添加逻辑来修改“...\DisplayTemplates\ApiGroup.cshtml”文件，以查看将要呈现的每个 api，并根据情况决定是否要包含它URL 中是否存在查询字符串。

不过，需要注意的重要一点是，这不会禁用该路由。您只是将其隐藏在此帮助页面上。如果您想禁用该路线，我认为您需要定义自己的自定义路线。