文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 报告与看板管理/ 保存进度报表 - SaveProgressReport
更新时间:2026-07-21 GMT+08:00
分享

保存进度报表 - SaveProgressReport

功能介绍

此接口用于保存进度报表

调用方法

请参见如何调用API

URI

POST /v4/{project_uuid}/versions/{version_uri}/progress-reports

表1 路径参数

参数

是否必选

参数类型

描述

project_uuid

String

参数解释

项目UUID,项目唯一标识

取值范围

字符串

version_uri

String

参数解释

版本URI

取值范围

字符串

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

report_name

String

报表名称

report_type

Integer

报表类型

chart_data

Array of ReportChartDataVo objects

图表数据

表3 ReportChartDataVo

参数

是否必选

参数类型

描述

id

String

参数解释

报表id

取值范围

不涉及

name

String

参数解释

报表名称

取值范围

不涉及

analyze_dim

ReportDimVo object

参数解释

分析维度数据

取值范围

不涉及

compare_dim

Array of ReportDimVo objects

参数解释

对比维度数据

取值范围

不涉及

表4 ReportDimVo

参数

是否必选

参数类型

描述

id

String

参数解释

id

取值范围

不涉及

name

String

参数解释

名称

取值范围

不涉及

value

Integer

参数解释

取值范围

不涉及

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

total

Integer

起始记录数 大于 实际总条数时,值为0,分页请求才有此值

value

String

实际的数据类型:单个对象,集合 或 NULL

reason

String

业务失败的提示内容

page_size

Integer

分页大小

page_no

Integer

分页编码

has_more

Boolean

是否有更多

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:500

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

请求示例

保存进度报表

POST https://{endpoint}/v4/{project_uuid}/versions/{version_uri}/progress-reports

{
  "report_name" : "进度报表1",
  "report_type" : 1
}

响应示例

状态码:200

OK

{
  "total" : 1,
  "value" : "report-uri-001",
  "reason" : "",
  "page_size" : 20,
  "page_no" : 1,
  "has_more" : false
}

状态码:400

Bad Request

{
  "error_code" : "CLOUDTEST.00000001",
  "error_msg" : "返回的错误信息"
}

状态码:500

Internal Server Error

{
  "error_code" : "CLOUDTEST.00000001",
  "error_msg" : "返回的错误信息"
}

状态码

状态码

描述

200

OK

400

Bad Request

500

Internal Server Error

错误码

请参见错误码

相关文档