搜索特性树 - SearchFeatures

功能介绍

搜索特性树

调用方法

请参见如何调用API。

URI

POST /v4/features/search

请求参数

表1 请求Body参数
参数	是否必选	参数类型	描述
version_uri	是	String	版本URI
project_uuid	是	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID
parent_uri	否	String	父节点URI
key_word	是	String	搜索关键字
page_no	是	Integer	当前页
page_size	是	Integer	每页条数

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
value	Array of SearchTestItemVo objects	请求返回的数据
total	Integer	总数
page_size	Integer	分页大小
page_no	String	分页编码

表3 SearchTestItemVo
参数	参数类型	描述
uri	String	资源URI
type	String	参数解释: 资源类型取值范围: TestCase，用例。 Task，任务。 TestVersion，分支。 IteratorTestCase，迭代用例。默认取值: 不涉及
author	String	创建人
name	String	名称
rank	Integer	级别
owner	String	责任人
frequence	String	frequence值
region	String	区域
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_id	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID
path_name	String	路径名称

状态码：400

表4 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：401

表5 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：404

表6 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：500

表7 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

请求示例

post https://{endpoint}/v4/features/search

{
  "project_uuid" : "9a5b66157ff44f6f80ce5f0fd1709f21",
  "version_uri" : "v92s00010cmov0d6",
  "key_word" : "aaa",
  "parent_uri" : null,
  "page_size" : 50,
  "page_no" : 1
}

响应示例

状态码：200

{
  "total" : 1,
  "value" : [ {
    "uri" : "v90100010qmb5kjn",
    "type" : "TestItem",
    "author" : "307262de1b3c485f9f74b8b9eec2ce37",
    "name" : "子目录333",
    "region" : "roma-devx-3",
    "last_modifier" : "307262de1b3c485f9f74b8b9eec2ce37",
    "last_modified" : "2025-09-30 15:00:31",
    "last_modified_timestamp" : 1759215631993,
    "last_change_time" : "2025-09-30 15:00:31",
    "version_uri" : "v90100010qgqgiub",
    "parent_uri" : "v90100010qgqgiub",
    "parent_path" : "/9d582bcc292a491e8d4d4c551102e70b/v90100010qgqgiub/",
    "creation_version_uri" : "v90100010qgqgj10",
    "creation_date" : "2025-09-30 15:00:31",
    "is_feature" : "0",
    "relate_htsm" : "0",
    "project_uuid" : "9d582bcc292a491e8d4d4c551102e70b"
  } ],
  "page_size" : 50,
  "page_no" : 1
}