odata - 如何记录 OData 端点（swagger、swashbuckle、其他）？

Question

记录 OData 端点的最佳方式是什么？有没有办法使用 Swashbuckle 呢？

score 8 · Accepted Answer

是的，试试Swashbuckle.OData。它添加了对 ODataControllers 的 Swashbuckle 支持。

score 5 · Accepted Answer

是的，我们正在尝试像 yaml -> Swagger、yaml -> csdl 一样支持它。

但它需要时间来实现，你可以看到一个原型并在那里跟踪https://github.com/OData/model-first

score 4 · Accepted Answer

实际上，我使用 Swashbuckle 中的 IDocumentFilter 函数得到了一些工作。我在 Swashbuckle 的 GitHub 存储库上回答了一个类似的问题。在此处查看我的回复（位于底部或底部）：

我已经发布了一个工作 IDocumentFilter 实现的示例，您可以利用它在 Swagger ui 中设置您的 OData 端点。

score 1 · Accepted Answer

然后将 spec 文档导入 swagger 就很容易了。

score 1 · Accepted Answer

Asp NET 和 Asp NET Core Api 版本控制

您可以对和使用Api 版本控制（因为它扩展ApiExplorer了 Odata 信息）。WebApiAspNetCore

两者都有可用的示例：

这个示例如何与Swashbuckle/Swagger ui很好地集成。