# 查询某测试计划下的操作历史 - ShowIteratorHistories
#### 功能介绍
此接口用于查询指定测试计划下的操作历史,包含测试计划添加/删除用例的操作历史记录,变更描述的操作历史记录等操作历史数据
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
GET /v4/testhub/projects/{project_id}/iterators/{iterator_uri}/histories
表1路径参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                 |
|:---|:---|:---|:---|
| project_id   | 是    | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) |
| iterator_uri | 是    | String | 计划uri                                                                                                              |
   
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述   |
|:---|:---|:---|:---|
| offset | 是    | Integer | 当前页数 |
| limit  | 是    | Integer | 每页条数 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数             | 参数类型                                                         | 描述                                   |
|:---|:---|:---|
| status         | String                                                       | success\|error                       |
| error          | [ApiError] object | 错误信息                                 |
| request_id     | String                                                       | 由接口调用方传入，建议使用UUID保证请求的唯一性。           |
| server_address | String                                                       | 本次请求的受理的服务地址                         |
| result         | Object                                                       | status为failed时，存放只有reason的ApiError对象 |
   
 表4ApiError 
| 参数     | 参数类型   | 描述        |
|:---|:---|:---|
| code   | String | 业务失败的错误编码 |
| reason | String | 业务失败的提示内容 |
   
**状态码：400**
表5响应Body参数 
| 参数         | 参数类型   | 描述                                 |
|:---|:---|:---|
| error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：401**
表6响应Body参数 
| 参数         | 参数类型   | 描述                                 |
|:---|:---|:---|
| error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：404**
表7响应Body参数 
| 参数         | 参数类型   | 描述                                 |
|:---|:---|:---|
| error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：500**
表8响应Body参数 
| 参数         | 参数类型   | 描述                                 |
|:---|:---|:---|
| error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 |
   
#### 请求示例
```
get https://{endpoint}/v4/projects/f3087a82b44744c29a1bd69ab6ada154/iterators/s32sadg553/histories?offset=1&limit=10
```
#### 响应示例
**状态码：200**
OK
```
[ {
  "project_id" : "1b7179edc79a431f9711434124ac9f28",
  "detail" : {
    "journalized_type" : "plan",
    "deleted" : [ ],
    "added" : [ {
      "name" : "SF01",
      "id" : "1185878300068290560"
    }, {
      "name" : "IR002",
      "id" : "1185878603530375169"
    } ],
    "type" : "issue",
    "updated" : [ ]
  },
  "operator" : {
    "name" : "222",
    "id" : "a17801c5d15f46e28112eec8a880683d"
  },
  "plan_id" : "v90200010s4auo7d",
  "operate_time" : "2025-10-18 15:11:47"
} ]
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。