文档首页/测试计划 CodeArts TestPlan/API参考/API/测试计划管理/查询某测试计划下的操作历史
更新时间：2025-04-30 GMT+08:00
查看PDF
分享

查询某测试计划下的操作历史

功能介绍

查询某测试计划下的操作历史

URI

GET /v1/projects/{project_id}/plans/{plan_id}/journals

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目id，项目唯一标识，固定长度32位字符，获取方式请参见获取项目ID。

约束限制:

项目唯一标识，固定长度32位

取值范围:

字母、数字

默认取值:

不涉及

plan_id

是

String

参数解释:

测试计划id，测试计划的唯一标识，长度11-34位字符

约束限制:

测试计划唯一标识，长度11-34位

取值范围:

字母、数字

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

offset

是

Long

参数解释:

起始偏移量，表示从此偏移量开始查询， offset大于等于0

参数限制:

大于等于0

取值范围:

0-2000000

默认取值:

不涉及

limit

是

Long

参数解释:

每页显示的条目数量,最大支持200条

参数限制:

大于等于0

取值范围:

1-200

默认取值:

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数

状态码：201

表4 响应Body参数

参数

参数类型

描述

[数组元素]

Array of TestPlanJournalList objects

参数解释:

项目下查询测试计划操作历史返回结构

取值范围:

不涉及

表5 TestPlanJournalList

参数

参数类型

描述

detail

Array of TestPlanJournalDetail objects

历史记录详情

operate_time

String

变更时间

operator

NameAndId object

参数解释:

测试计划迭代编号与迭代名称

取值范围:

不涉及

plan_id

String

参数解释:

测试计划id

取值范围:

11-34位字符

project_id

String

参数解释:

项目id，项目唯一标识，固定长度32位字符

取值范围:

32位固定长度字符

表6 TestPlanJournalDetail

参数

参数类型

描述

added

Array of NameAndId objects

测试计划资源的添加记录（工作项或者测试用例）

deleted

Array of NameAndId objects

测试计划资源的移除记录（工作项或者测试用例）

journalized_type

String

参数解释:

表明该条变更记录的具体变更类型，例如测试用例（testCase），需求（issue）

取值范围:

不涉及

type

String

参数解释:

表明该条变更记录属于基础信息变更还是资源（需求添加移除、用例添加移除）变更

取值范围:

不涉及

updated

Array of AttributeChange objects

参数解释:

测试计划基础信息变更，包括计划名称，测试类型，计划处理者、版本号、关联迭代、开始日期、截至日期、描述

取值范围:

不涉及

表7 NameAndId

参数

参数类型

描述

id

String

参数解释:

对象编号

取值范围:

不涉及

name

String

参数解释:

对象名称

取值范围:

不涉及

表8 AttributeChange

参数

参数类型

描述

attribute_type

String

参数解释:

发生变更的测试计划属性

取值范围:

不涉及

new_value

String

参数解释:

变更后的取值

取值范围:

不涉及

old_value

String

参数解释:

变更前的取值

取值范围:

不涉及

状态码：400

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：401

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：404

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：500

表12 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

get https://{endpoint}/v1/projects/efdb403066474ab08836b9eeaaa23bca/plans/9b26f58ec29943f681804a6628779a23/journals?offset=1&limit=10

响应示例

状态码：201

OK

[ {
  "detail" : [ {
    "added" : [ {
      "id" : "ID",
      "name" : "名称"
    } ],
    "deleted" : [ {
      "id" : "ID",
      "name" : "名称"
    } ],
    "journalized_type" : "plan",
    "type" : "resource/attribute",
    "updated" : [ {
      "attribute_type" : "name",
      "new_value" : "tester",
      "old_value" : "test"
    } ]
  } ],
  "operate_time" : "2021-07-10",
  "operator" : {
    "id" : "ID",
    "name" : "名称"
  },
  "plan_id" : "c7c2ddf2ea914164ac6ee76bf11a30ea",
  "project_id" : "9b26f58ec29943f681804a6628779a23"
} ]

状态码

状态码

描述

201

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题：测试计划管理