能否通过单次API调用获取HubSpot Deal关联联系人属性？

问题背景 #

已知Deal ID（示例：38741794733），当前调用以下端点获取Deal数据及关联联系人：

GET https://api.hubapi.com/crm/v4/objects/deals/38741794733?associations=contacts

返回响应仅包含联系人ID，无属性信息。若需获取联系人firstname、lastname、email等属性，需针对每个联系人发起二次API调用：

GET https://api.hubapi.com/crm/v4/objects/contacts/{contactId}?properties=firstname,lastname,email

这会增加资源消耗与响应时间，尤其当Deal关联多个联系人时。

需求：是否可仅凭Deal ID，通过单次API请求同时获取Deal属性及关联联系人的指定属性（如firstname、lastname、email）？理想目标：

• 扩展关联对象（contacts），无需额外请求即可直接获取其属性
• 单次响应返回Deal及关联联系人的完整数据

已尝试的操作：

• 查阅/crm/v4/objects/deals与/crm/v3/objects/contacts官方文档
• 使用?associations=contacts仅获取到联系人ID
• 寻找类似GraphQL的associationsProperties或expand参数，但未找到

解决方案 #

可以通过单次API请求实现需求，只需在原请求中添加associationsProperties参数，指定需要获取的联系人属性即可。

最终请求示例 #

GET https://api.hubapi.com/crm/v4/objects/deals/38741794733?associations=contacts&associationsProperties=firstname,lastname,email

补充说明 #

• 该请求会返回目标Deal的默认属性，同时在关联的contacts节点下，会包含每个联系人的firstname、lastname、email属性，无需发起二次请求。
• 如果需要指定Deal自身返回的属性，可额外添加properties参数，示例：

  GET https://api.hubapi.com/crm/v4/objects/deals/38741794733?properties=dealname,amount&associations=contacts&associationsProperties=firstname,lastname,email
  

内容的提问来源于stack exchange，提问作者Angel Paredes