文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试报表管理/ 服务首页看板统计-统计用例完成率与用例通过率 - GetHomePageOverviewInfoCase
更新时间：2026-10-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

服务首页看板统计-统计用例完成率与用例通过率 - GetHomePageOverviewInfoCase

功能介绍

此接口用于获取统计用例完成率与用例通过率数据,传入版本uri后,可以分别统计并获取:用例完成率,用例通过率信息数据

项目首页顶部导航栏“服务”->“测试计划”页面下，“我的测试看板”中统计的用例完成率与用例通过率

调用方法

请参见如何调用API。

URI

POST /v4/projects/{project_id}/home/overview/case

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目UUID，项目唯一标识。获取方式请参见获取项目ID

约束限制:

不涉及

取值范围:

长度等于32位，包含大小写字母、数字

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表3 请求Body参数

参数

是否必选

参数类型

描述

version_uri

是

String

版本URI

module_id

否

String

模块ID

fixed_version_id

否

String

筛选迭代ID

owner_id

否

String

处理人

pi_filter

否

PiFilterInfo object

pi筛选条件

own

否

Boolean

是否是我的
表4 PiFilterInfo

参数

是否必选

参数类型

描述

pi_sprints

否

Array of PiInfo objects

参数解释

pi迭代筛选条件

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

all_pi

否

Boolean

参数解释

pi下拉框全选标识

约束限制

不涉及

取值范围

全选时为true

默认取值

不涉及
表5 PiInfo

参数

是否必选

参数类型

描述

sprints

否

Array of strings

参数解释

迭代列表

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

pi_id

否

String

参数解释

pi的id

约束限制

不涉及

取值范围

层级关系：pi -> 迭代 -> 需求

默认取值

不涉及

响应参数

状态码：200

表6 响应Body参数

参数

参数类型

描述

value

HomePageOverviewVo object

请求返回的数据
表7 HomePageOverviewVo

参数

参数类型

描述

case_completion_rate

CaseCompletionRateVo object

计算用例完成率

case_pass_rate

CasePassRateVo object

计算用例通过率

defect_status

DefectStatusVo object

统计缺陷信息，组装缺陷状态分组信息

defect_severity

DefectSeverityVo object

统计缺陷信息，组装缺陷重要程度分组信息
表8 CaseCompletionRateVo

参数

参数类型

描述

total

Integer

总用例数

completion_rate

String

用例完成率

status_number_list

Array of NameAndValueVo objects

用户自定义状态对应的用例数目
表9 CasePassRateVo

参数

参数类型

描述

pass_rate

String

用例通过率

result_number_list

Array of NameAndValueVo objects

用户自定义结果对应的用例数目
表10 DefectStatusVo

参数

参数类型

描述

total

Integer

缺陷数

not_solved

Integer

未关闭缺陷数

status_number_list

Array of NameAndValueVo objects

每种状态的名称和对应的数目
表11 DefectSeverityVo

参数

参数类型

描述

total

Integer

缺陷数

severity_number_list

Array of NameAndValueVo objects

每种重要程度的名称和对应的数目
表12 NameAndValueVo

参数

参数类型

描述

name

String

参数解释

名称，如缺陷重要程度名称或用例执行结果名称

取值范围

不涉及

value

Integer

参数解释

对应名称的数目

取值范围

大于等于0

children

Array of children objects

参数解释

子节点，数组内每个元素包含名称、值和标记值

取值范围

不涉及
表13 children

参数

参数类型

描述

name

String

参数解释

名称

取值范围

不涉及

value

Integer

参数解释

对应名称的数目

取值范围

大于等于0

tag_value

Integer

参数解释

标记值，与value的区别在于标识不同维度的统计数值

取值范围

大于等于0

状态码：400

表14 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：401

表15 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：404

表16 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：500

表17 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

实时计算单个自定义报表

post https://{endpoint}/v4/projects/f3087a82b44744c29a1bd69ab6ada154/home/overview/case

{
  "owner_id" : "ffb8caecd62b41c7929121c181d11064",
  "version_uri" : "v92s000100lum5pi"
}

响应示例

状态码：200

{
  "value" : {
    "case_completion_rate" : {
      "total" : 2,
      "completion_rate" : "100.0%",
      "status_number_list" : [ {
        "name" : "完成",
        "value" : 2
      } ]
    },
    "case_pass_rate" : {
      "pass_rate" : "100.0%",
      "result_number_list" : [ {
        "name" : "成功",
        "value" : 2
      } ]
    }
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题： 测试报表管理

相关文档