# 外部系统查询项目下迭代列表 - ShowIterators #### 功能介绍 此接口用于查询项目下的测试计划列表,同页面 测试 -\> 测试计划 -\> 右侧列表 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI GET /v4/testhub/projects/{project_id}/iterators 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | offset | 是 | Integer | 偏移量 | | limit | 是 | Integer | 每页条数 | | name | 否 | String | 查询迭代名 | | current_stage | 否 | String | 计划所处阶段 | | branch_uri | 否 | String | 分支Uri，默认master | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | status | String | **参数解释**: 调用此接口的响应状态。 **取值范围**: - success，表示接口调用成功。 - error，表示接口调用失败。 | | error | [ApiError] object | 错误信息 | | request_id | String | 由接口调用方传入，建议使用UUID保证请求的唯一性。 | | server_address | String | 本次请求的受理的服务地址 | | result | Array of [ExternalServiceShowIteratorsVo] objects | status为failed时，存放只有reason的ApiError对象 | 表4ApiError | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及 | | reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 | 表5ExternalServiceShowIteratorsVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 迭代名称 | | owner | [NameAndIdVo] object | 处理者 | | creator | [NameAndIdVo] object | 创建者 | | iteration | [NameAndIdVo] object | 迭代 | | plan_id | String | 迭代uri | | project_id | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | current_stage | String | 迭代计划所处节点 | | expire_day | Long | 超期天数 | | start_date | String | 开始时间 | | end_date | String | 结束时间 | | finish_date | String | 实际完成时间 | | design_stage | [ExternalServiceDesignStageVo] object | 设计阶段统计数据 | | execute_stage | [ExternalServiceExecuteStageVo] object | 执行阶段统计数据 | | report_stage | [ExternalServiceReportStageVo] object | 报告阶段统计数据 | | branch_name | String | 分支版本名称 | | branch_id | String | 分支版本id | 表6NameAndIdVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释** ID **取值范围** 不涉及 | | name | String | **参数解释** 名称 **取值范围** 不涉及 | 表7ExternalServiceDesignStageVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | case_count | Integer | 用例个数 | | issue_count | Integer | 需求个数 | | issue_covered_count | Integer | 已被用例关联的需求个数 | 表8ExternalServiceExecuteStageVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | defect_count | Integer | 缺陷个数 | | completed_defect_count | Integer | 已完成缺陷个数 | | case_pass_rate | String | 用例通过率,按用例结果计算 | | executed_case_count | Integer | 已执行用例数, 按用例状态统计 | 表9ExternalServiceReportStageVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | case_complete_rate | String | 用例完成率,按状态统计 | **状态码：400** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：401** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：404** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：500** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | #### 请求示例 ``` get https://{endpoint}/v4/testhub/projects/{project_id}/iterators?offset=0&limit=10 ``` #### 响应示例 **状态码：200** OK ``` [ { "owner" : { "name" : "wangluodan1", "id" : "a17801c5d15f46e28112eec8a880683d" }, "end_date" : "2025-10-23 23:59:59", "design_stage" : { "issue_count" : 0, "case_count" : 2, "issue_covered_count" : 0 }, "creator" : { "name" : "wangluodan1", "id" : "a17801c5d15f46e28112eec8a880683d" }, "report_stage" : { "case_complete_rate" : "0" }, "project_id" : "1b7179edc79a431f9711434124ac9f28", "finish_date" : "", "execute_stage" : { "completed_defect_count" : 0, "case_pass_rate" : "0", "executed_case_count" : 0, "defect_count" : 0 }, "name" : "Plan001", "expire_day" : -5, "current_stage" : "design", "plan_id" : "v90100010s233kci", "start_date" : "2025-10-01 00:00:00" }, { "owner" : { "name" : "wangluodan1", "id" : "a17801c5d15f46e28112eec8a880683d" }, "end_date" : "2025-10-24 23:59:59", "design_stage" : { "issue_count" : 0, "case_count" : 10, "issue_covered_count" : 0 }, "creator" : { "name" : "wangluodan1", "id" : "a17801c5d15f46e28112eec8a880683d" }, "report_stage" : { "case_complete_rate" : "10.0%" }, "project_id" : "1b7179edc79a431f9711434124ac9f28", "finish_date" : "", "execute_stage" : { "completed_defect_count" : 0, "case_pass_rate" : "10.0%", "executed_case_count" : 1, "defect_count" : 0 }, "name" : "样例测试计划", "expire_day" : -6, "current_stage" : "execute", "plan_id" : "v90200010s1h64al", "start_date" : "2025-10-17 00:00:00" } ] ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。