为什么在API中使用$ ref的Microsoft Graph API?

时间:2018-03-19 12:23:08

标签: rest api microsoft-graph api-design

我注意到Microsoft Graph API经常在URI中使用$ref

例如a member can be added to an Office 365 Group使用以下HTTP请求:

POST /groups/{id}/members/$ref

为什么使用$ref后缀?这是否提供任何价值或优势?在这种情况下,这有什么特别的意义吗?

1 个答案:

答案 0 :(得分:5)

Microsoft正在实施OData。第4.4 Addressing References between Entities部分解释了$ref

  

OData服务基于支持关系作为第一类构造的数据模型。例如,OData服务可以公开Products实体的集合,每个实体都与Category实体相关。

     

实体之间的引用可以在OData中寻址,就像实体本身一样(如上所述),方法是将一个导航属性名称后跟/ $ ref附加到实体URL。