外部系统获取资源修改历史记录 - ShowTesthubResourceHistories

功能介绍

获取资源修改历史记录

调用方法

URI

POST /v4/testhub/projects/{project_id}/resources/{resource_uri}/histories/batch-query

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID
resource_uri	是	String	资源uri

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
offset	是	Integer	起始偏移
limit	是	Integer	每页展示条数
version_id	是	String	分支/测试计划id

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
status	String	success\|error
error	ApiError object	错误信息
request_id	String	由接口调用方传入，建议使用UUID保证请求的唯一性。
server_address	String	本次请求的受理的服务地址
result	ExternalPageVoListTestCaseHistoryExternalVo object	请求结果

表4 ApiError
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

表5 ExternalPageVoListTestCaseHistoryExternalVo
参数	参数类型	描述
total	Long	总数
values	Array of TestCaseHistoryExternalVo objects	结果集合

表6 TestCaseHistoryExternalVo
参数	参数类型	描述
author	String	资源历史记录创建人
region	String	逻辑region
changes	Array of ResourceChangeExternalVo objects	历史记录字段变更列表
id	String	历史记录id
testcase_id	String	用例id
creation_date	String	创建时间
create_date_timestamp	Long	创建时间时间戳
author_name	String	创建人名称
project_id	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID

表7 ResourceChangeExternalVo
参数	参数类型	描述
field_name	String	变更字段
custom_field_type	String	测试用例自定义字段类型
old_change_info	ElementResourceChangeExternalVo object	变更前的数据信息
new_change_info	ElementResourceChangeExternalVo object	变更后的数据信息

表8 ElementResourceChangeExternalVo
参数	参数类型	描述
tracker_name	String	工作项类型
value	String	值
key	String	key
object_value	Object	对象值
object_key	Object	对象key
tracker_names	Object	缺陷类型
board_info	Array of objects	归属看板信息，用例关联工作项信息使用

状态码：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	参数解释: 接口调用失败错误信息取值范围: 不涉及

请求示例

post https://{endpoint}/v4/testhub/projects/c4e36f20d35a4720a1647e8e6215b737/resources/v90600010i8ev89s/histories/batch-query

{
  "offset" : 1,
  "limit" : 20,
  "version_id" : "1d4fgf5gexss13"
}

响应示例

状态码：200

{
  "total" : 1,
  "values" : [ {
    "author_name" : "wangluodan1",
    "author" : "a17801c5d15f46e28112eec8a880683d",
    "changes" : [ {
      "new_change_info" : {
        "value" : "12312"
      },
      "old_change_info" : { },
      "field_name" : "description"
    } ],
    "id" : "v90200010s4k5sql",
    "testcase_id" : "v90200010s48bmvs",
    "creation_date" : "2025-10-18 14:23:01",
    "region" : "roma-guian-2",
    "create_date_timestamp" : 1760768581000
  } ]
}