OData V3中是否必须提供服务文档？

Question

OData V3中是否必须包含元数据文档和服务文档？

根据第10.1.2章中的V3核心Protocal规范，它说OData服务必须公开一个元数据文档，它定义了服务公开的所有数据。

所以我相信OData V3中必须使用元数据文档，对吧？ 但是V3中的Service Document呢？

感谢任何人的帮助，

Answer 1

根据v3规范：

  

2.2.3.7.1服务文件

     

对于客户端与数据服务交互，它需要发现可用资源集合的位置。 AtomPub [RFC5023]定义服务文档以支持此发现过程。

     

数据服务的ServiceRoot必须识别数据服务的服务文档。

更重要的是，服务文档的一般概念是一个非常重要且基本的REST API概念。 REST说应该有一个允许通用超媒体客户端遍历服务的入口点。这将是一个很好的时间来解释George Orwell: all REST principles are important but some are more important than others。拥有服务文档将是其中一个更重要的＆＃34;如果您关心像Excel这样的通用OData客户端，那就是原则。