WebAPI 帮助页面不显示 OData 控制器的所有端点

Question

我使用 OData 为我的 ASP.NET MVC Web API 添加了帮助页面组件。为了使其正常工作，我必须明确指定 [ApiExplorerSetting(IgnoreAPI = false)]。

但是，它只显示默认的 GET 端点，例如：api/Customers。

但我的 API 也支持 GET by ID 和一些导航属性，例如：api/Customers(id) 和 api/Customers(id)/ContactPerson

有没有办法让帮助页面自动生成这些端点？

谢谢！

Answer 1

基于 OData 的控制器确实不支持HelpPage，这就是我们在ODataController 上显式设置[ApiExplorerSetting(IgnoreAPI = true)] 属性的原因。即使您尝试将此设置设为false，也不能保证所有内容（显示所有路线、生成的样本）都会按预期工作，因此我建议不要采用这种方法。