文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 分支迭代操作管理/ 搜索用例的特性树 - ListSearchFeaturesByTestCase
更新时间：2025-12-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

搜索用例的特性树 - ListSearchFeaturesByTestCase

功能介绍

此接口用于查询指定项目,版本下,指定用例是否存在子节点,并返回子节点信息

调用方法

请参见如何调用API。

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

case_uri

是

String

用例uri

service_types

是

Array of integers

服务类型

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

status

String

参数解释:

调用此接口的响应状态。

取值范围:

  • success，表示接口调用成功。

  • error，表示接口调用失败。

result

ResultValueTestItemTreeVo object

请求返回的数据

error

ApiError object

错误信息。

request_id

String

由接口调用方传入，建议使用UUID保证请求的唯一性。

server_address

String

本次请求的受理的服务地址
表4 ResultValueTestItemTreeVo

参数

参数类型

描述

total

Integer

起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值

value

TestItemTreeVo object

请求返回的数据

reason

String

业务失败的提示内容

page_size

Integer

分页大小

page_no

Integer

分页编码

has_more

Boolean

是否有更多
表5 TestItemTreeVo

参数

参数类型

描述

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

case_total

Integer

用例总数

execd_total

Integer

执行总数

is_direct_relation

Boolean

is_direct_relation

has_child

Boolean

是否有子特性

is_other_feature

Boolean

是否为其他目录
表6 ApiError

参数

参数类型

描述

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

错误码

请参见错误码。

相关文档