如何查找特定实体记录的子引用？REST API账户关联子实体查询

我来给你梳理两种实用的方法，帮你通过REST API找到账户实体关联的所有子实体（比如联系人这类）：

方法一：直接利用实体导航属性查询 #

每个账户实体都自带对应的导航属性，用来直接关联子实体。比如要获取某账户下的所有联系人，直接调用以下GET请求即可：

GET [你的组织URI]/api/data/v9.2/accounts(<目标账户ID>)/contacts

• 把<目标账户ID>替换成你要查询的账户记录的GUID；
• 如果需要指定返回的字段，可以加上$select参数，比如只获取联系人姓名和邮箱：

GET [你的组织URI]/api/data/v9.2/accounts(<目标账户ID>)/contacts?$select=fullname,emailaddress1

• 要是子实体记录数量较多，API会自动分页，你可以通过返回结果里的@odata.nextLink字段来获取后续页面的数据。

方法二：先查元数据确定所有关联子实体，再逐个查询 #

如果你不确定账户关联了哪些子实体，可以先通过元数据API获取所有一对多关系：

GET [你的组织URI]/api/data/v9.2/EntityDefinitions(LogicalName='account')/OneToManyRelationships

返回的结果里，每个对象都包含以下关键信息：

• ReferencingEntity：子实体的逻辑名称（比如contact）；
• ReferencingAttribute：子实体中用来关联账户的字段（比如联系人的parentcustomerid）。

拿到这些信息后，就可以针对每个子实体发起查询，比如查询所有关联目标账户的联系人：

GET [你的组织URI]/api/data/v9.2/contacts?$filter=parentcustomerid eq <目标账户ID>

其他子实体的查询逻辑类似，只需要替换对应的实体逻辑名和关联字段即可。

注意事项 #

• 确保调用API的用户拥有对应子实体的读取权限，否则会返回权限不足的错误；
• 请替换URL中的v9.2为你实际使用的Dynamics 365版本号；
• 对于一些自定义的关联关系，同样可以通过元数据API找到对应的导航属性或关联字段。

内容的提问来源于stack exchange，提问作者Pavlo Mykhailyshyn