如何通过Jira Rest API提取测试用例及执行结果

Jira 原生 Issue REST API 默认仅返回系统核心字段，测试用例、测试执行/测试运行相关数据不属于Jira核心Issue模型的默认返回范畴：网页端能看到相关内容，是因为前端自动关联拉取了测试管理模块（要么是Jira自带测试功能，要么是Xray、Zephyr这类第三方测试插件）的独立数据做了关联展示，不会默认包含在基础Issue接口的返回JSON里。

• 第一步：先全量拉取字段确认测试关联项
  先调用Jira核心字段接口 GET /rest/api/2/field 拉取当前实例的全量字段列表，筛选名称带「测试用例」「测试执行」「Test Case」「Test Execution」「Test Result」相关的字段，记录对应customfield_xxxxx格式的自定义字段ID。
  后续查询Issue时，在请求参数中添加fields=*all，或者把记录的自定义字段ID拼入fields参数，就能在Issue返回的JSON中拿到关联测试项的基础关联信息，示例请求：

  GET /rest/api/2/search?jql=project=你的项目标识&fields=summary,status,customfield_10023,customfield_10027
  

• 第二步：调用对应测试模块的专属API拿完整执行数据

  注意：测试运行明细、步骤级执行结果、执行历史、执行人/执行时间这类动态数据是独立存储的实体，哪怕你给基础Issue接口开了全字段返回，也拿不到这部分完整内容，必须调用对应测试能力的专属接口：

  • 如果你用的是Xray测试插件：直接调用Xray自带的REST端点，传入关联测试用例的Issue Key，即可拉取全量测试执行、测试运行的结构化数据，返回JSON中会直接包含testRun、testExecutionKey、测试状态、执行备注等核心字段
  • 如果你用的是Zephyr（Scale/Squad）测试插件：不要用Jira核心API查询，直接调用Zephyr专属的REST接口，通过测试用例ID关联查询对应测试循环下的所有测试运行记录
  • 如果你用的是Jira原生Test Management模块：调用Jira测试管理的专属REST端点，传入测试用例Issue ID即可拉取全量执行历史、结果明细
• 第三步：快速定位接口的实操方法
  打开网页端带测试结果的Issue页面，按F12调出开发者工具切到「网络」面板，刷新页面后筛选Fetch/XHR请求，在响应内容里找包含测试结果数据的请求，直接参考该请求的路径、参数结构即可，不需要手动猜字段和接口路径。如果自定义字段里仅返回了测试项的数字ID，拿这个ID去对应测试模块的接口做入参查询，就能拿到完整详情。

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