Azure DevOps调用WIQL查询API如何获取工作项标题字段

你当前调用的WIQL查询接口默认设计就只会返回匹配工作项的ID与详情访问URL，不会直接返回标题、工作项类型这类业务字段，按以下两步操作即可拿到你需要的内容：

• 第一步：保留你当前的WIQL接口调用逻辑，从返回结果中提取所有匹配工作项的id值，组成ID列表
• 第二步：调用工作项批量查询接口，传入收集到的ID列表，同时指定需要返回的字段集合，就能拿到包括标题在内的所有你需要的工作项属性

批量查询接口说明 #

请求方式：POST
请求地址格式：

https://dev.azure.com/{Org}/{Project}/_apis/wit/workitemsbatch?api-version=6.0

请求体示例：

{
  "ids": [1001, 1002, 1003],
  "fields": [
    "System.Id",
    "System.Title",
    "System.WorkItemType",
    "System.State"
  ]
}

参数说明：

• ids：替换为第一步从WIQL结果中拿到的所有工作项ID
• fields：填入你需要返回的字段引用名，其中System.Title就是你需要的工作项标题字段，System.WorkItemType可以用来区分产品待办项、Bug、任务等不同类型的工作项，你可以按需增减需要的字段

注意：单次批量查询接口最多支持传入200个工作项ID，如果WIQL返回的结果总数超过200，需要分批传入ID调用接口，再把多批次返回的结果合并即可。

额外优化 #

你最初需要的按标签筛选关联工作项的能力，不需要提前在UI界面创建保存查询，可以直接调用WIQL的POST接口，在请求体中直接写WIQL查询语句，在查询条件中加入System.Tags Contains '目标标签值'的筛选规则即可，能省掉提前在UI建查询的步骤。

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