文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 特性目录相关管理/ 搜索特性树 - SearchFeatures
更新时间：2025-12-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

搜索特性树 - 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

OK

{
  "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
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

相关文档