
# 根据用例查询评审记录 - QueryTestCaseReviews
#### 功能介绍
此接口用于根据用例查询评审记录，同页面 测试 -\> 测试用例 -\> 右侧展示用例列表，点击右上角评审记录 -\> 进入评审记录详情页 -\> 上方搜索栏可根据用例信息进行筛选 -\> 下方展示筛选后的评审记录
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
GET /GT3KServer/v4/testcases/{testcase_uri}/review
表1路径参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| testcase_uri | 是    | String | **参数解释** 分支用例URI **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 |
   
表2Query参数 
| 参数           | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| project_uuid | 是    | String  | **参数解释** 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **约束限制** 不涉及 **取值范围** 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 **默认取值** 不涉及 |
| version_uri  | 是    | String  | **参数解释** 版本URI值 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                          |
| page_no      | 是    | Integer | **参数解释** 当前页数 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                            |
| page_size    | 是    | Integer | **参数解释** 每页条数 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                            |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数        | 参数类型                                                                                  | 描述                                                                                                                                                             |
|:---|:---|:---|
| total     | Integer                                                                               | **参数解释** 总数 **取值范围** 不小于1的正整数          |
| page_no   | Integer                                                                               | **参数解释** 分页编码 **取值范围** 大于0且小于100的正整数   |
| page_size | Integer                                                                               | **参数解释** 分页大小 **取值范围** 大于零且小于20000的正整数 |
| value     | Array of [TestCaseReviewVo] objects | **参数解释** 测试用例评审信息 **取值范围** 不涉及         |
   
 表4TestCaseReviewVo 
| 参数                               | 参数类型                                                                        | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| 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                                                                     | 用例类型                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   
 表5NameAndIdVo 
| 参数   | 参数类型   | 描述                                                                                                                                               |
|:---|:---|:---|
| id   | String | **参数解释** ID **取值范围** 不涉及 |
| name | String | **参数解释** 名称 **取值范围** 不涉及 |
   
**状态码：400**
表6响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                        |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：401**
表7响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                        |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：404**
表8响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                        |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：500**
表9响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                        |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
#### 请求示例
```
GET https://{endpoint}/GT3KServer/v4/testcases/v901000109n3a3mt/review?project_uuid=90f8dc52eb7b4c47b853c661152ca62d&version_uri=v902000108vdtjkp&page_no=1&page_size=10
```
#### 响应示例
**状态码：200**
OK
```
{
  "total" : 2,
  "page_no" : 1,
  "page_size" : 5,
  "value" : [ {
    "uri" : "v90200010arlc1fc",
    "testcase_name" : "apitest01",
    "testcase_number" : "102",
    "testcase_uri" : "v902000107pabud4",
    "version_uri" : "v901000106dij34m",
    "version_name" : "用例库",
    "comment" : "评审不通过",
    "reviewer" : "wtt_apitest",
    "status" : "1",
    "expect_close_date" : "2025-03-26",
    "expect_close_date_timestamp" : 1742918400000
  }, {
    "uri" : "v90200010arlbi9e",
    "testcase_name" : "apitest01",
    "testcase_number" : "102",
    "testcase_uri" : "v902000107pabud4",
    "version_uri" : "v901000106dij34m",
    "version_name" : "用例库",
    "comment" : "评审通过",
    "reviewer" : "wtt_apitest",
    "status" : "0",
    "expect_close_date" : "2025-03-17"
  } ]
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。
