文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试结果管理/ 设置单个用例结果 - AddCaseResult
更新时间：2026-10-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

设置单个用例结果 - AddCaseResult

功能介绍

此接口用于设置单个用例结果

调用方法

请参见如何调用API。

URI

POST /v4/{project_uuid}/versions/{version_uri}/testcases/{case_uri}/results

表1 路径参数

参数

是否必选

参数类型

描述

project_uuid

是

String

参数解释

项目UUID，项目唯一标识

取值范围

字符串

version_uri

是

String

参数解释

版本URI

取值范围

字符串

case_uri

是

String

参数解释

用例URI

取值范围

字符串

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

uri

否

String

主键

name

否

String

结果名字

description

否

String

描述

result

否

String

用例结果

status

否

String

任务状态

preparation

否

String

前置条件

steps

否

Array of TestCaseStepResultInfo objects

用例步骤结果信息

release_dev

否

String

版本号

task_uri

否

String

任务URI

task_result_uri

否

String

测试套结果URI
表3 TestCaseStepResultInfo

参数

是否必选

参数类型

描述

result

否

String

步骤结果值

actual_result

否

String

步骤实际结果

expect_result

否

String

步骤期望结果

test_step

否

String

用例操作步骤

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

total

Integer

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

value

TestResultVo object

实际的数据类型：单个对象，集合 或 NULL

reason

String

业务失败的提示内容

page_size

Integer

每页展示条数

page_no

Integer

页码

has_more

Boolean

是否有更多
表5 TestResultVo

参数

参数类型

描述

uri

String

参数解释

用例执行结果的唯一标识URI

取值范围

11-34位字母及数字

name

String

参数解释

用例结果名称，用于标识本次用例执行的结果记录

取值范围

不涉及

author

String

参数解释

用例结果创建人的用户ID

取值范围

不涉及

rank

Integer

参数解释

用例的优先级级别

取值范围

  • 0：Priority 0

  • 1：Priority 1

  • 2：Priority 2

  • 3：Priority 3

  • 4：Priority 4

result

Integer

参数解释

测试结果Code，用于标识用例的执行结果

取值范围

不涉及

round

Integer

参数解释

用例执行的批次编号

取值范围

大于等于1的整数

preparation

String

参数解释

用例执行的前置条件

取值范围

不涉及

description

String

参数解释

用例结果描述

取值范围

不涉及

region

String

参数解释

用例结果所属的逻辑Region

取值范围

不涉及

steps

Array of ResultStepVo objects

参数解释

用例执行的步骤列表，每个步骤包含步骤内容、预期结果和实际结果，具体请参见ResultStepVo数据结构

取值范围

不涉及

number

String

参数解释

用例结果编号

取值范围

不涉及

author_name

String

参数解释

用例结果创建人的用户名称

取值范围

不涉及

begin_time

String

参数解释

用例执行的开始时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

begin_time_timestamp

Long

参数解释

执行开始时间的时间戳，单位为毫秒

取值范围

不涉及

end_time

String

参数解释

用例执行的结束时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

end_time_timestamp

Long

参数解释

执行结束时间的时间戳，单位为毫秒

取值范围

不涉及

creation_date

String

参数解释

用例结果创建时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

creation_date_timestamp

Long

参数解释

用例结果创建时间的时间戳，单位为毫秒

取值范围

不涉及

last_modified

String

参数解释

最后修改时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

last_modified_timestamp

Long

参数解释

最后修改时间的时间戳，单位为毫秒

取值范围

不涉及

last_change_time

String

参数解释

用例结果最后变更的时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

last_change_time_timestamp

Long

参数解释

最后变更时间的时间戳，单位为毫秒

取值范围

不涉及

dfx_test_result

String

参数解释

DFX测试结果

取值范围

不涉及

failure_cause

String

参数解释

用例执行失败的原因

取值范围

不涉及

parent_uri

String

参数解释

父节点的唯一标识，为分支用例URI或迭代用例URI，用于标识当前用例结果所属的父级用例

取值范围

不涉及

test_case_uri

String

参数解释

分支用例的唯一标识

取值范围

不涉及

test_case_name

String

参数解释

测试用例的名称

取值范围

不涉及

task_uri

String

参数解释

测试任务的唯一标识

取值范围

不涉及

result_name

String

参数解释

测试结果的中文名称，如通过、失败等

取值范围

不涉及

test_result_ae

String

参数解释

是否自动化执行

取值范围

  • '0'：非自动化执行

  • '1'：自动化执行

executor_id

String

参数解释

执行该用例的用户的唯一标识

取值范围

不涉及

executor_name

String

参数解释

执行该用例的用户名称

取值范围

不涉及

task_id

String

参数解释

执行机任务ID

取值范围

不涉及

execute_id

String

参数解释

执行ID

取值范围

不涉及

time_cost

Integer

参数解释

执行耗时，单位为毫秒

取值范围

不涉及

step_txt

String

参数解释

用例执行的测试步骤文本内容

取值范围

不涉及

step_expect

String

参数解释

测试步骤期望结果

取值范围

不涉及

step_actual

String

参数解释

测试步骤的实际执行结果描述

取值范围

不涉及

step_result

String

参数解释

测试步骤的执行结果状态

取值范围

不涉及

release_dev

String

参数解释

版本号

取值范围

不涉及

creation_version_uri

String

参数解释

创建版本URI

取值范围

不涉及

version_uri

String

参数解释

用例结果所属版本的唯一标识

取值范围

不涉及

project_uuid

String

参数解释

项目UUID，项目唯一标识

取值范围

固定长度32位字符（字母和数字）

report_url

String

参数解释

第三方过来的执行结果，返回跳转到第三方的url

取值范围

不涉及

test_case_number

String

参数解释

测试用例的编号，用于唯一标识用例

取值范围

不涉及

service_type

String

参数解释:

服务类型

取值范围:

  • -1：全量用例

  • 0：手工测试

  • 1：接口自动化

  • 7：功能自动化

  • 8：WebUI自动化

  • 100：自定义自动化(工厂)

  • 11：性能自动化
表6 ResultStepVo

参数

参数类型

描述

result

String

参数解释

测试步骤的执行结果状态码

取值范围

不涉及

test_step

String

参数解释

测试步骤的具体操作描述

取值范围

不涉及

expect_result

String

参数解释

测试步骤的预期执行结果

取值范围

不涉及

actual_result

String

参数解释

测试步骤的实际执行结果

取值范围

不涉及

result_name

String

参数解释

测试步骤执行结果的中文名称，如通过、失败等

取值范围

不涉及

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：500

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

设置单个用例结果

POST https://{endpoint}/v4/{project_uuid}/versions/{version_uri}/testcases/{case_uri}/results

{
  "result" : 0
}

响应示例

状态码：200

{
  "total" : 1,
  "value" : {
    "case_uri" : "case-001",
    "result" : 0,
    "executed_at" : 1700000000000
  },
  "reason" : ""
}

状态码：400

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

状态码：500

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

状态码

状态码

描述

200

OK

400

Bad Request

500

Internal Server Error

错误码

请参见错误码。

父主题： 测试结果管理

相关文档