如何通过YouTrack API获取自定义字段变更活动数据？State字段值异常

问题原因 #

YouTrack API默认不会自动展开嵌套对象的所有字段，当返回StateBundleElement类型的数据时，仅会返回$type标识，不会包含状态名称等具体属性。

解决步骤 #

在请求/api/issues/{issueID}/activities接口时，通过fields查询参数显式指定需要返回的嵌套字段，就能获取到状态的实际值。

示例请求URL #

/api/issues/{issueID}/activities?fields=added(name,id),removed(name,id),author(name),created

• added(name,id)：指定获取新增状态对象的名称（name）和ID（id）
• removed(name,id)：指定获取移除状态对象的名称和ID
• author(name)、created：保留你原本能获取到的操作用户和变更时间字段

返回结果示例 #

此时added或removed字段会返回包含实际状态值的完整对象：

{
  "$type": "StateBundleElement",
  "name": "Open",
  "id": "67-3"
}

参考文档说明 #

YouTrack开发者文档中关于ActivityItem支持字段的说明：
针对字段变更类的ActivityItem，added和removed字段对应BundleElement类型的对象（State字段对应StateBundleElement）。若未在请求中指定要展开的字段，接口仅会返回对象的类型标识$type；需通过fields参数显式声明所需的嵌套属性，才能获取完整数据。

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