求可获取Azure Test Plan特定套件内测试用例执行历史及次数的API

1. 修正Test History API的调用错误 #

你调用Test History API时的报错是因为缺少有效的groupBy参数，该API要求必须指定分组方式。正确的请求需要包含groupBy字段，有效值包括testCase、automatedTestName等。

修正后的请求示例：

POST https://dev.azure.com/{organization}/{project}/_apis/test/Results/testhistory?api-version=6.0-preview.2
Content-Type: application/json

请求体：

{
    "testCaseId": 82167,
    "groupBy": "testCase"
}

该调用会返回对应测试用例的完整执行历史，统计返回结果的条目数即可得到执行次数。

2. 获取指定套件内所有测试用例的执行历史与次数 #

要批量处理整个套件内的测试用例，按以下步骤操作：

• 第一步：获取套件内测试用例ID列表
  使用你已尝试的API提取目标套件的测试用例ID：

  GET https://dev.azure.com/{organization}/{project}/_apis/testplan/Plans/{planId}/Suites/{suiteId}/TestCase?api-version=5.0-preview.2
  

  从返回结果中提取所有testCase.id字段，得到套件内的测试用例ID集合。

• 第二步：批量查询执行结果
  使用Test Results Query API批量查询多个测试用例的执行历史，减少逐个调用的开销：

  POST https://dev.azure.com/{organization}/{project}/_apis/test/results/query?api-version=6.0
  Content-Type: application/json
  

  请求体示例（替换为你的测试用例ID列表）：

  {
      "queries": [
          {
              "queryType": "testCase",
              "testCaseIds": [82167, 82168, 82169],
              "fields": ["testCaseId", "outcome", "completedDate"]
          }
      ]
  }
  

• 第三步：统计执行次数
  对返回结果按testCaseId分组，统计每个ID对应的结果条目数，即为该测试用例的执行次数。

3. 可选：关联测试点的执行历史 #

如果需要关联测试点（Test Point）的执行记录，可以结合两个API操作：

1. 用Test Point API获取套件内所有测试点，提取每个测试点的testCaseId和pointId；
2. 查询特定测试点的执行历史：

   GET https://dev.azure.com/{organization}/{project}/_apis/test/results?testPointId={pointId}&api-version=6.0
   

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