更新时间:2025-06-26 GMT+08:00
分享

批量新增用例评审

功能介绍

批量新增用例评审

调用方法

请参见如何调用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

错误码

请参见错误码

相关文档