文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 评审管理/ 搜索用例评审记录 - SearchTestCaseReview
更新时间:2026-07-21 GMT+08:00
分享

搜索用例评审记录 - SearchTestCaseReview

功能介绍

此接口用于搜索用例评审记录,同页面 测试 -> 测试用例 -> 右侧列表,点击用例进入详情页 -> 点击评审记录

调用方法

请参见如何调用API

URI

POST /v4/testcases/review/search

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

reviewer

String

评审人

comment

String

评审意见

status

String

参数解释:

闭环状态

约束限制:

不涉及

取值范围:

  • 0,未闭环。

  • 1,已闭环。

默认取值:

不涉及

project_uuid

String

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

version_uri

String

版本URI

feature_uri

String

特性目录URI

testcase_number

String

用例编号

testcase_name

String

用例名

close_user_id

String

指定闭环人

actual_close_person

String

实际闭环人

close_comment

String

闭环意见

review_start_date

String

评审开始时间

review_end_date

String

评审结束时间

close_start_date

String

闭环开始时间

close_end_date

String

闭环结束时间

page_no

Integer

当前页数

page_size

Integer

每页条数,最大值100

sort_field

String

排序字段

sort_type

String

参数解释:

排序方式

约束限制:

不涉及

取值范围:

  • ASC,升序。

  • DESC,降序。

默认取值:

不涉及

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

total

Integer

参数解释

总数

取值范围

不小于1的正整数

page_no

Integer

参数解释

分页编码

取值范围

大于0且小于100的正整数

page_size

Integer

参数解释

分页大小

取值范围

大于零且小于20000的正整数

value

Array of TestCaseReviewVo objects

参数解释

测试用例评审信息

取值范围

不涉及

表3 TestCaseReviewVo

参数

参数类型

描述

uri

String

参数解释

评审URI

取值范围

不涉及

testcase_name

String

参数解释

用例名称

取值范围

不涉及

testcase_number

String

参数解释

用例编号

取值范围

不涉及

testcase_stage

String

参数解释

用例阶段

取值范围

不涉及

testcase_last_modified

String

用例修改时间

testcase_last_modified_timestamp

Long

用例修改时间时间戳

testcase_uri

String

参数解释

分支用例URI

取值范围

不涉及

version_uri

String

参数解释

版本URI

取值范围

不涉及

version_name

String

参数解释

版本名称

取值范围

不涉及

comment

String

参数解释

评审意见

取值范围

不涉及

close_comment

String

闭环意见

reviewer

String

参数解释

评审人

取值范围

不涉及

creation_date

String

评审创建时间

creation_date_timestamp

Long

评审创建时间时间戳

close_user_ids

Array of NameAndIdVo objects

指定的闭环人列表

actual_close_person

String

实际闭环人

status

String

参数解释:

评审状态

取值范围:

  • 0,未评审。

  • 1,已评审。

close_date

String

评审闭环时间

close_date_timestamp

Long

评审闭环时间时间戳

expect_close_date

String

参数解释

期望闭环时间

取值范围

不涉及

expect_close_date_timestamp

Long

参数解释

期望闭环时间时间戳

取值范围

不涉及

case_type

Integer

用例类型

表4 NameAndIdVo

参数

参数类型

描述

id

String

参数解释

ID

取值范围

不涉及

name

String

参数解释

名称

取值范围

不涉及

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:401

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:404

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:500

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

post https://{endpoint}/v4/testcases/review/search

{
  "reviewer" : "1001",
  "comment" : "评审",
  "status" : "1",
  "project_uuid" : "bc472858dbe54bb5ac0a473cad0eed12",
  "version_uri" : "63dasd3baf",
  "feature_uri" : "63dasd3baf",
  "testcase_number" : "1001",
  "testcase_name" : "1001",
  "close_user_id" : "1001",
  "actual_close_person" : "1001",
  "close_comment" : "评审",
  "review_start_date" : "2022-10-31 00:00:00",
  "review_end_date" : "2022-10-31 00:00:00",
  "close_start_date" : "2022-10-31 00:00:00",
  "close_end_date" : "2022-10-31 00:00:00",
  "page_no" : 1,
  "page_size" : 10,
  "sort_field" : "testCaseNumber",
  "sort_type" : "ASC"
}

响应示例

状态码:200

OK

{
  "total": 1,
  "value": [
    {
      "uri": "63dasd3bad",
      "testcase_name": "用例1",
      "testcase_number": "用例1",
      "testcase_stage": "1",
      "testcase_last_modified": "2022-11-01 00:00:00",
      "testcase_last_modified_timestamp": 1660617231016,
      "testcase_uri": "63dasd3baf",
      "version_uri": "63dasd3baf",
      "version_name": "BaseLine",
      "comment": "建议修改用例名称",
      "close_comment": "通过",
      "reviewer": "z000001",
      "creation_date": "2022-10-31 00:00:00",
      "creation_date_timestamp": 1660617231016,
      "close_user_ids": [
        "z000001",
        "z000002"
      ],
      "actual_close_person": "z000001",
      "status": "1",
      "close_date": "2022-10-31 00:00:00",
      "close_date_timestamp": 1660617231016,
      "expect_close_date": "2022-10-31",
      "expect_close_date_timestamp": 1660617231016
    }
  ],
  "page_size": 0,
  "page_no": 0,
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档