# 搜索用例的特性树 - ListSearchFeaturesByTestCase #### 功能介绍 此接口用于查询指定项目,版本下,指定用例是否存在子节点,并返回子节点信息 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/features/search-by-case #### 请求参数 表1请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 主账号用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 | 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | version_uri | 是 | String | 版本URI | | project_uuid | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | case_uri | 是 | String | 用例uri | | service_types | 是 | Array of integers | 服务类型 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | status | String | **参数解释**: 调用此接口的响应状态。 **取值范围**: - success，表示接口调用成功。 - error，表示接口调用失败。 | | value | [TestItemTreeVo] object | 请求返回的数据 | | error | [ApiError] object | 错误信息。 | | request_id | String | 由接口调用方传入，建议使用UUID保证请求的唯一性。 | | server_address | String | 本次请求的受理的服务地址 | 表4TestItemTreeVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | 资源URI | | type | String | **参数解释**: 资源类型 **取值范围**: - TestCase，用例。 - Task，任务。 - TestVersion，分支。 - IteratorTestCase，迭代用例。 | | author | String | 创建人 | | name | String | 名称 | | rank | Integer | 级别 | | owner | String | 责任人 | | frequence | String | frequence值 | | region | String | 区域 | | children | Array of [TestItemTreeVo] objects | 子节点 | | last_modifier | String | 最后修改人 | | last_modified | String | 最后修改时间 | | last_modified_timestamp | Long | 修改时间时间戳 | | last_change_time | String | 最后变更时间 | | version_uri | String | 版本URI | | origin_uri | String | 源资源URI | | parent_uri | String | 父资源URI | | parent_path | String | 父资源路径 | | creation_version_uri | String | 创建版本URI | | creation_date | String | 创建时间 | | creation_date_timestamp | Long | 创建时间时间戳 | | author_name | String | 创建人名称 | | comment | String | 备注 | | number | String | 编号 | | is_feature | String | 是否特性 | | relate_htsm | String | 是否关联特性 | | aw_unique_id | String | aw id | | test_mind_id | String | 脑图id | | test_mind_url | String | 脑图url | | project_uuid | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | case_total | Integer | 用例总数 | | execd_total | Integer | 执行总数 | | is_direct_relation | Boolean | is_direct_relation | | has_child | Boolean | 是否有子特性 | | is_other_feature | Boolean | 是否为其他目录 | 表5ApiError | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | 响应码 | | reason | String | 业务失败的提示内容 | #### 请求示例 ``` post https://{endpoint}/v4/features/search-by-case { "version_uri" : "15a9eb8ee74a", "project_uuid" : "2e8b14eb90d54b6c9bc4c0b5cde1f449", "case_uri" : "15a9eb8ee74a", "service_types" : [ 0 ] } ``` #### 响应示例 **状态码：200** OK ``` { "value" : { "uri" : "001s16gt6q5", "type" : "TestVersion", "author" : "efdb403066474ab08836b9eeaaa23bca", "name" : "名称", "rank" : 1, "owner" : "责任人", "frequence" : "fb567305-6c30-4fdc-aa51-b3cc83a96ceb", "region" : "cn-north-7", "children" : [ ], "last_modifier" : "efdb403066474ab08836b9eeaaa23bca", "last_modified" : "2025-06-19T09:21:55.073Z", "last_modified_timestamp" : 1660617231016, "last_change_time" : "2025-06-19T09:21:55.073Z", "version_uri" : "001s16gt68e", "origin_uri" : "001rv5i9u14", "parent_uri" : "001s16gt68e", "parent_path" : "/b6c4288728234a2e804b6df9465d7b5b/001s16gt68e", "creation_version_uri" : "001s16gt68e", "creation_date" : "2025-06-19T09:21:55.073Z", "creation_date_timestamp" : 1660617231016, "author_name" : "tester", "comment" : "备注", "number" : "编号", "is_feature" : "1", "relate_htsm" : "0", "aw_unique_id" : "0", "test_mind_id" : "saw2aw7x4sjk", "test_mind_url" : "7ws37623xf20", "project_uuid" : "7568jtfrc324e15a9eb8ee74a96a474", "case_total" : 1, "execd_total" : 1, "is_direct_relation" : true, "has_child" : true, "is_other_feature" : true } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。