文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 特性目录管理/ 获取特性树 - ShowFeatureChildrenFour
更新时间:2026-06-12 GMT+08:00
分享

获取特性树 - ShowFeatureChildrenFour

功能介绍

此接口用于递归查询特性树,同页面 测试 -> 测试用例 -> 左侧特性目录

调用方法

请参见如何调用API

URI

POST /v4/features/{feature_uri}/children

表1 路径参数

参数

是否必选

参数类型

描述

feature_uri

String

特性uri

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

owner

String

参数解释

责任人

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

stage

String

参数解释

阶段

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

activity

String

参数解释

活动

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

version_uri

String

参数解释

版本URI

约束限制

不涉及

取值范围

11-34为字母数字

默认取值

不涉及

task_uri

String

参数解释

任务URI

约束限制

不涉及

取值范围

11-34为字母数字

默认取值

不涉及

service_type

String

参数解释:

用例服务类型

约束限制:

不涉及

取值范围:

  • -1,全量用例。

  • 0,手工测试。

  • 1,接口自动化。

  • 7,功能自动化。

  • 8,WebUI自动化。

  • 100,自定义自动化(工厂)。

  • 11,性能自动化。

默认取值:

不涉及

contain_total

Boolean

参数解释

是否包含用例数

约束限制

不涉及

取值范围

  • true,包含。

  • false,不包含。

默认取值

不涉及

project_uuid

String

参数解释

项目UUID,

约束限制

不涉及

取值范围

项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

默认取值

不涉及

sort_type

String

参数解释:

排序类型

约束限制:

不涉及

取值范围:

  • ASC,升序。

  • DESC,降序。

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

value

Array of TestItemVo objects

获取特性树返回参数

表4 TestItemVo

参数

参数类型

描述

uri

String

参数解释

资源URI

取值范围

11-34位字母或数字

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

取值范围

11-34位字母或数字

origin_uri

String

参数解释

源资源URI

取值范围

不涉及

parent_uri

String

参数解释

父资源URI

取值范围

不涉及

parent_path

String

参数解释

父资源路径

取值范围

不涉及

creation_version_uri

String

参数解释

创建版本URI

取值范围

11-34位字母或数字

creation_date

String

参数解释

创建时间

取值范围

不涉及

creation_date_timestamp

Long

参数解释

创建时间时间戳

取值范围

不涉及

author_name

String

参数解释

创建人名称

取值范围

不涉及

comment

String

参数解释

备注

取值范围

不涉及

number

String

参数解释

编号

取值范围

不涉及

is_feature

String

参数解释

是否特性

取值范围

  • true,是。

  • false,否。

relate_htsm

String

参数解释

是否关联特性

取值范围

  • true,是。

  • false,否。

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

参数解释

是否有子特性

取值范围

  • true,是。

  • false,否。

状态码: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/features/v90200010aelu5om/children

{
  "project_uuid" : "3cb3c18b74f1429783175e6dab05b351"
}

响应示例

状态码:200

OK

{
  "value" : [ {
    "uri" : "v90200010h980ss9",
    "type" : "TestItem",
    "author" : "2ce06fffb4634271a377c1cd7c429704",
    "name" : "子目录2333",
    "region" : "roma-dev-2-arm",
    "last_modifier" : "2ce06fffb4634271a377c1cd7c429704",
    "last_modified" : "2025-06-05 16:34:06",
    "last_modified_timestamp" : 1749112446000,
    "last_change_time" : "2025-06-05 16:34:06",
    "version_uri" : "v90200010aelu5om",
    "parent_uri" : "v90200010aelu5om",
    "parent_path" : "/407ac57de7ea44d28e47293a2b9cf15c/v90200010aelu5om/",
    "creation_version_uri" : "v90200010aelu5om",
    "creation_date" : "2025-06-05 16:34:06",
    "creation_date_timestamp" : 1749112446000,
    "number" : "11232131231",
    "is_feature" : "0",
    "relate_htsm" : "0",
    "project_uuid" : "407ac57de7ea44d28e47293a2b9cf15c",
    "case_total" : 2,
    "execd_total" : 0,
    "is_direct_relation" : true,
    "has_child" : true
  }, {
    "uri" : "",
    "name" : "其他",
    "parent_path" : "407ac57de7ea44d28e47293a2b9cf15c",
    "is_feature" : "0",
    "relate_htsm" : "0",
    "project_uuid" : "407ac57de7ea44d28e47293a2b9cf15c",
    "case_total" : 7325,
    "execd_total" : 0,
    "is_direct_relation" : false,
    "has_child" : false
  } ]
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档