咨询：DevOps REST API工作项评论接口缺失asOf参数的解决方案

很遗憾，目前Azure DevOps REST API 5.1版本中，WIT评论接口确实没有官方支持的asOf参数——你尝试的未文档化参数无效是预期结果，这类参数要么不存在，要么随时可能被移除，完全不具备可靠性。

针对你的需求，这里有几个经过验证的可行方案，按实现成本和精准度排序：

1. 基于评论时间戳客户端过滤（最推荐） #

这是目前最直接且可靠的替代方案，和你提到的思路一致：

• 先调用评论接口获取目标工作项的所有评论（包含修订版和已删除评论）：

  GET https://dev.azure.com/{org}/{proj}/_apis/wit/workitems/{id}/comments?api-version=5.1-preview.3&includeDeleted=true
  

• 在本地客户端对返回结果进行过滤：
  • 保留createdDate早于或等于目标asOf时刻的评论
  • 对于有修订记录的评论（通过revisedDate判断），只保留修订时间早于或等于asOf时刻的最新版本

这个方案的优势是实现简单，无需额外权限，仅有的小缺点是如果工作项有大量评论会产生少量额外数据传输，但对于绝大多数场景来说完全够用。

2. 解析工作项修订历史的System.History字段（精准快照） #

如果需要绝对匹配asOf时刻工作项的完整状态（包括当时显示的评论内容），可以通过工作项的修订记录来实现：

• 调用工作项修订接口，获取asOf时刻对应的工作项版本：

  GET https://dev.azure.com/{org}/{proj}/_apis/wit/workitems/{id}/revisions?api-version=5.1-preview.3&asOf={asOfTimestamp}
  

• 从返回的修订数据中提取System.History字段，这个字段存储了该版本工作项的所有历史变更（包括评论的创建、编辑记录）。

注意：System.History是结构化的文本格式，需要你自行解析其中的评论作者、时间、内容等信息，解析逻辑会略复杂，但能精准还原asOf时刻工作项的评论状态。

3. 使用Azure DevOps Analytics API（批量场景优化） #

如果是批量处理多个工作项的历史评论快照，可以借助Analytics API的时间过滤能力：

• 通过Analytics API的评论端点，使用$filter参数直接筛选出创建时间早于asOf时刻的评论，避免客户端过滤的开销。

这个方案适合批量场景，但需要额外配置Analytics API的权限，且数据存在几分钟的延迟，适合非实时的批量分析需求。

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