文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 评审管理/ 批量新增用例评审
更新时间：2025-06-26 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量新增用例评审

功能介绍

批量新增用例评审

调用方法

请参见如何调用API。

URI

POST /v4/testcases/batch-review

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

comment

否

String

用例评审

project_id

是

String

项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID

testcase_uris

是

Array of strings

分支用例URIs

version_uri

是

String

版本URI

auto_close

是

Boolean

是否自动闭环

close_user_ids

是

Array of strings

闭环人列表

expect_close_date

否

String

期望闭环时间

expect_close_date_timestamp

否

Long

期望闭环时间时间戳

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

status

String

success|error

result

ResultValueBatchTestCaseReviewVo object

请求返回的数据

error

ApiError object

错误信息

request_id

String

由接口调用方传入，建议使用UUID保证请求的唯一性。

server_address

String

本次请求的受理的服务地址
表3 ResultValueBatchTestCaseReviewVo

参数

参数类型

描述

total

Integer

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

value

BatchTestCaseReviewVo object

请求返回的数据

reason

String

业务失败的提示内容

page_size

Integer

分页大小

page_no

Integer

分页编码

has_more

Boolean

是否有更多
表4 BatchTestCaseReviewVo

参数

参数类型

描述

create_num

String

创建数目

close_num

String

闭环数目

delete_num

String

删除数目

exception_num

String

异常错误数目

exception_msg

Array of TestCaseReviewValidateExceptionVo objects

异常错误信息
表5 TestCaseReviewValidateExceptionVo

参数

参数类型

描述

testcase_review_uri

String

评审URI

testcase_uri

String

分支用例URI

testcase_name

String

用例名称

testcase_number

String

用例编号

testcase_stage

String

用例阶段

reason

String

原因
表6 ApiError

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：401

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：404

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：500

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

post https://{endpoint}/v4/testcases/batch-review

{
  "comment" : "这是一条用例评审",
  "project_id" : "bc472858dbe54bb5ac0a473cad0eed12",
  "testcase_uris" : [ "1f22e3511dd348e3", "8131b4066afbd0b4" ],
  "version_uri" : "1f22e3511dd348e3",
  "auto_close" : false,
  "close_user_ids" : [ "10001", "10002" ],
  "expect_close_date" : "2022-10-31",
  "expect_close_date_timestamp" : 1660617231016
}

响应示例

状态码：200

OK

{
  "status" : "string",
  "result" : {
    "total" : 1,
    "value" : {
      "create_num" : "1",
      "close_num" : "1",
      "delete_num" : "1",
      "exception_num" : "1",
      "exception_msg" : [ {
        "testcase_review_uri" : "63dasd3baf",
        "testcase_uri" : "63dasd3baf",
        "testcase_name" : "用例1",
        "testcase_number" : "1001",
        "testcase_stage" : "1",
        "reason" : "无权限操作"
      } ]
    },
    "reason" : "string",
    "page_size" : 1,
    "page_no" : 1,
    "has_more" : true
  },
  "error" : { }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题： 评审管理

相关文档