外部系统查询项目下迭代列表 - ShowIterators
功能介绍
外部系统查询项目下迭代列表
调用方法
请参见如何调用API。
URI
GET /v4/testhub/projects/{project_id}/iterators
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
是 |
Integer |
偏移量 |
|
limit |
是 |
Integer |
每页条数 |
|
name |
否 |
String |
查询迭代名 |
|
current_stage |
否 |
String |
计划所处阶段 |
|
branch_uri |
否 |
String |
分支Uri，默认master |
请求参数
无
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
status |
String |
参数解释: 调用此接口的响应状态。 取值范围:
|
|
error |
ApiError object |
错误信息 |
|
request_id |
String |
由接口调用方传入，建议使用UUID保证请求的唯一性。 |
|
server_address |
String |
本次请求的受理的服务地址 |
|
result |
Array of ExternalServiceShowIteratorsVo objects |
status为failed时，存放只有reason的ApiError对象 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
迭代名称 |
|
owner |
NameAndIdVo object |
处理者 |
|
creator |
NameAndIdVo object |
创建者 |
|
iteration |
NameAndIdVo object |
迭代 |
|
plan_id |
String |
迭代uri |
|
project_id |
String |
项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID |
|
current_stage |
String |
迭代计划所处节点 |
|
expire_day |
Long |
超期天数 |
|
start_date |
String |
开始时间 |
|
end_date |
String |
结束时间 |
|
finish_date |
String |
实际完成时间 |
|
design_stage |
ExternalServiceDesignStageVo object |
设计阶段统计数据 |
|
execute_stage |
执行阶段统计数据 |
|
|
report_stage |
ExternalServiceReportStageVo object |
报告阶段统计数据 |
|
branch_name |
String |
分支版本名称 |
|
branch_id |
String |
分支版本id |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
case_count |
Integer |
用例个数 |
|
issue_count |
Integer |
需求个数 |
|
issue_covered_count |
Integer |
已被用例关联的需求个数 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
defect_count |
Integer |
缺陷个数 |
|
completed_defect_count |
Integer |
已完成缺陷个数 |
|
case_pass_rate |
String |
用例通过率,按用例结果计算 |
|
executed_case_count |
Integer |
已执行用例数, 按用例状态统计 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释: 接口调用失败错误码 取值范围: 不涉及 |
|
error_msg |
String |
参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码：401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释: 接口调用失败错误码 取值范围: 不涉及 |
|
error_msg |
String |
参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码：404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释: 接口调用失败错误码 取值范围: 不涉及 |
|
error_msg |
String |
参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
错误码
请参见错误码。
