# 外部系统获取资源修改历史记录 - ShowTesthubResourceHistories #### 功能介绍 此接口用于获取资源修改历史记录,如用例的操作历史,同页面 测试 -\> 测试用例 -\> 点击用例 -\> 页签中点击操作历史 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/testhub/projects/{project_id}/resources/{resource_uri}/histories/batch-query 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | 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 | 请求结果 | 表4ApiError | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及 | | reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 | 表5ExternalPageVoListTestCaseHistoryExternalVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Long | 总数 | | values | Array of [TestCaseHistoryExternalVo] objects | 结果集合 | 表6TestCaseHistoryExternalVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | 表7ResourceChangeExternalVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | field_name | String | 变更字段 | | custom_field_type | String | 测试用例自定义字段类型 | | old_change_info | [ElementResourceChangeExternalVo] object | 变更前的数据信息 | | new_change_info | [ElementResourceChangeExternalVo] object | 变更后的数据信息 | 表8ElementResourceChangeExternalVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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** OK ``` { "result" : { "total" : 0, "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 } ] } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。