项目下查询测试计划列表
功能介绍
项目下查询测试计划列表
URI
GET /v1/projects/{project_id}/plans
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 参数解释: 项目id,项目唯一标识,固定长度32位字符,获取方式请参见获取项目ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
name | 否 | String | 参数解释: 模糊查询使用(针对测试计划名称) 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 。 |
current_stage | 否 | String | 参数解释: 测试计划所处阶段(create,design,execute,report) 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 。 |
offset | 是 | Integer | 参数解释: 偏移量,取值范围为0-2000000 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 。 |
limit | 是 | Integer | 参数解释: 每页显示的条目数量,取值范围为1-100 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 参数解释: 用户Token。 约束限制: 不涉及 取值范围: 字符串长度不少于1,不超过100000 默认取值: 不涉及 |
响应参数
状态码:201
参数 | 参数类型 | 描述 |
|---|---|---|
[数组元素] | Array of TestPlanDetail objects | 项目下查询测试计划列表返回结构 |
参数 | 参数类型 | 描述 |
|---|---|---|
creator | creator object | 参数解释: 测试计划创建者信息 取值范围: 不涉及 |
current_stage | String | 参数解释: 当前测试计划所处的阶段 取值范围: 不涉及 |
design_stage | design_stage object | 参数解释: 测试计划设计阶段信息 取值范围: 不涉及 |
end_date | String | 参数解释: 测试计划截止时间 取值范围: 不涉及 |
execute_stage | execute_stage object | 参数解释: 测试计划执行阶段信息 取值范围: 不涉及 |
expire_day | Integer | 参数解释: 获取超期时间,正值表示已超期 取值范围: 不涉及 |
finish_date | String | 参数解释: 测试计划实际完成时间(测试计划实际完成指测试计划下所有测试用例处于完成状态) 取值范围: 不涉及 |
iteration | NameAndId object | 参数解释: 测试计划迭代编号与迭代名称 取值范围: 不涉及 |
name | String | 参数解释: 测试计划名称 取值范围: 不涉及 |
owner | owner object | 参数解释: 测试计划处理者信息 取值范围: 不涉及 |
plan_id | String | 参数解释: 测试计划id 取值范围: 不涉及 |
project_id | String | 参数解释: 项目id,对应"需求管理 CodeArts Req"项目唯一标识,测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字 默认取值: 不涉及 |
report_stage | report_stage object | 参数解释: 报告阶统计数据 取值范围: 不涉及 |
start_date | String | 参数解释: 测试计划开始时间 取值范围: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
id | String | 参数解释: 测试计划创建者id 取值范围: 不涉及 |
nick_name | String | 参数解释: 测试计划创建者的昵称 取值范围: 当用户未设置昵称时不返回该字段 |
user_name | String | 参数解释: 测试计划创建者的用户名称 取值范围: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
case_count | Integer | 参数解释: 用例个数 取值范围: 不涉及 |
issue_count | Integer | 参数解释: 需求个数 取值范围: 不涉及 |
issue_covered_count | String | 参数解释: 已被用例关联的需求个数 取值范围: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
case_pass_rate | String | 参数解释: 用例通过率,按用例结果计算 取值范围: 不涉及 |
completed_defect_count | Integer | 参数解释: 已完成缺陷个数 取值范围: 不涉及 |
defect_count | Integer | 参数解释: 缺陷个数 取值范围: 不涉及 |
executed_case_count | Integer | 参数解释: 已执行用例数, 按用例状态统计 取值范围: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
id | String | 参数解释: 测试计划处理者id 取值范围: 不涉及 |
name | String | 参数解释: 测试计划处理者名称,优先返回nickName,不存在则返回userName 取值范围: 不涉及 |
nick_name | String | 参数解释: 测试计划处理者的昵称,当用户未设置昵称时不返回该字段 取值范围: 不涉及 |
user_name | String | 参数解释: 测试计划处理者的用户名称 取值范围: 不涉及 |
状态码: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}/v1/projects/efdb403066474ab08836b9eeaaa23bca/plans?offset=1&limit=10¤t_stage 响应示例
状态码:201
OK
[ {
"creator" : {
"id" : "efdb403066474ab08836b9eeaaa23bca",
"nick_name" : "测试Tester",
"user_name" : "测试Tester"
},
"current_stage" : "design",
"design_stage" : {
"case_count" : 2,
"issue_count" : 0,
"issue_covered_count" : "0"
},
"end_date" : "2021-07-10",
"execute_stage" : {
"case_pass_rate" : "0.00%",
"completed_defect_count" : 0,
"defect_count" : 0,
"executed_case_count" : 0
},
"expire_day" : -4,
"finish_date" : "2021-07-10",
"iteration" : {
"id" : "ID",
"name" : "名称"
},
"name" : "测试",
"owner" : {
"id" : "efdb403066474ab08836b9eeaaa23bca",
"name" : "测试Tester",
"nick_name" : "测试Tester",
"user_name" : "测试Tester"
},
"plan_id" : "c7c2ddf2ea914164ac6ee76bf11a30ea",
"project_id" : "9b26f58ec29943f681804a6628779a23",
"report_stage" : {
"case_complete_rate" : "100.00%"
},
"start_date" : "2021-07-10"
} ] 状态码
状态码 | 描述 |
|---|---|
201 | OK |
400 | Bad Request |
401 | Unauthorized |
404 | Not Found |
500 | Internal Server Error |
错误码
请参见错误码。

