# 搜索用例评审记录 - SearchTestCaseReview #### 功能介绍 此接口用于搜索用例评审记录，同页面 测试 -\> 测试用例 -\> 右侧列表，点击用例进入详情页 -\> 点击评审记录 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/testcases/review/search #### 请求参数 表1请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | reviewer | 否 | String | 评审人 | | comment | 否 | String | 评审意见 | | status | 否 | String | **参数解释**: 闭环状态 **约束限制**: 不涉及 **取值范围**: - 0，未闭环。 - 1，已闭环。 **默认取值**: 不涉及 | | project_uuid | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | 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 | **参数解释** 测试用例评审信息 **取值范围** 不涉及 | 表3TestCaseReviewVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 用例类型 | 表4NameAndIdVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。