更新时间:2026-10-22 GMT+08:00
分享

获取特性树 - ShowFeatureChildrenFive

功能介绍

此接口用于获取指定特性目录下的子集,根据传入的feature_uri,获取节点下的子目录数据

调用方法

请参见如何调用API。

URI

POST /v5/features/{feature_uri}/children

表1 路径参数

参数

是否必选

参数类型

描述

feature_uri

是

String

特性uri

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

owner

否

String

参数解释:

责任人,用于筛选指定责任人下的子特性

约束限制:

不涉及

取值范围:

1-128中英文、数字字符

默认取值:

无

stage

否

String

参数解释:

阶段,用于筛选指定测试阶段下的子特性

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

activity

否

String

参数解释:

活动,用于筛选指定测试活动下的子特性

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

version_uri

否

String

参数解释:

版本URI,用于筛选指定版本下的子特性。获取方式请参见获取版本URI接口

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

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

约束限制

不涉及

取值范围

项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字

默认取值

不涉及

sort_type

否

String

参数解释:

排序类型

约束限制:

不涉及

取值范围:

  • ASC,升序。

  • DESC,降序。

默认取值:

不涉及

page_number

否

Integer

参数解释:

页码,用于指定查询结果的页码

约束限制:

不涉及

取值范围:

大于等于1的正整数

默认取值:

无

page_size

否

Integer

参数解释:

每页数量,用于指定每页返回的子特性数量,单位:条

约束限制:

不涉及

取值范围:

大于等于1的正整数

默认取值:

无

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

total

Integer

参数解释

符合条件的所有记录数

取值范围

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

value

Array of TestItemVo objects

参数解释:

本次查询的记录结果

取值范围:

实际的数据类型:单个对象,集合 或 NULL

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

page_size

Integer

参数解释:

每页展示条数

取值范围:

不涉及

page_no

Integer

参数解释:

页码

取值范围:

不涉及

has_more

Boolean

参数解释:

是否有更多

取值范围:

true:是 false:否

表4 TestItemVo

参数

参数类型

描述

uri

String

参数解释:

资源URI

取值范围:

11-34位的字母及数字(字符串)

type

String

参数解释:

资源类型

取值范围:

  • TestCase,用例。

  • Task,任务。

  • TestVersion,分支。

  • IteratorTestCase,迭代用例。

author

String

参数解释:

创建人

取值范围:

字符串类型,长度小于128个字符

name

String

参数解释:

名称

取值范围:

字符串类型,长度小于128个字符

rank

Integer

参数解释:

级别

取值范围:

不涉及

owner

String

参数解释:

责任人

取值范围:

字符串类型,长度小于128个字符

frequence

String

参数解释:

执行频率

取值范围:

不涉及

region

String

参数解释:

区域

取值范围:

不涉及

last_modifier

String

参数解释:

最后修改人

取值范围:

不涉及

last_modified

String

参数解释:

最后修改时间

取值范围:

不涉及

last_modified_timestamp

Long

参数解释:

修改时间时间戳

取值范围:

时间戳格式,单位为毫秒

last_change_time

String

参数解释:

最后变更时间

取值范围:

时间格式为"yyyy-MM-dd HH:mm:ss"

version_uri

String

参数解释:

版本URI

取值范围:

11-34位字母、数字组成的字符串

origin_uri

String

参数解释:

源资源URI

取值范围:

11-34位字母、数字组成的字符串

parent_uri

String

参数解释:

父资源URI

取值范围:

11-34位字母、数字组成的字符串

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

参数解释:

是否特性

取值范围:

  • '0':非特性

  • '1':特性

relate_htsm

String

参数解释:

是否关联特性

取值范围:

  • true:是

  • false:否

aw_unique_id

String

参数解释:

自动化关键字唯一标识

取值范围:

不涉及

test_mind_id

String

参数解释:

脑图id

取值范围:

长度小于128个字符的字符串

test_mind_url

String

参数解释:

脑图url

取值范围:

长度小于128个字符的字符串

project_uuid

String

参数解释:

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

取值范围:

32位字母和数字组成的字符串

case_total

Integer

参数解释:

用例总数

取值范围:

大于等于1的正整数,单位:个

execd_total

Integer

参数解释:

执行总数

取值范围:

大于等于1的正整数,单位:个

is_direct_relation

Boolean

参数解释:

是否为直接关联

取值范围:

  • true:是

  • false:否

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}/v5/features/v90100010gpop318/children?_=1750318026886

{
  "project_uuid" : "3cb3c18b74f1429783175e6dab05b351",
  "version_uri" : "v90100010p0crcjn"
}

响应示例

状态码:200

{
  "value" : [ {
    "uri" : "v90100010s4o04ue",
    "type" : "TestItem",
    "author" : "7e63d38da4e94105b69c5cf88991aaae",
    "name" : "woca",
    "region" : "roma-guian-2",
    "last_modifier" : "7e63d38da4e94105b69c5cf88991aaae",
    "last_modified" : "2025-10-18 15:29:47",
    "last_modified_timestamp" : 1760772587471,
    "last_change_time" : "2025-10-18 15:29:47",
    "version_uri" : "v90100010p0crcjn",
    "parent_uri" : "v90100010p0crcjn",
    "parent_path" : "/3cb3c18b74f1429783175e6dab05b351/v90100010p0crcjn/",
    "creation_version_uri" : "v90100010p0crcjn",
    "creation_date" : "2025-10-18 15:29:47",
    "creation_date_timestamp" : 1760772587471,
    "is_feature" : "0",
    "relate_htsm" : "0",
    "project_uuid" : "3cb3c18b74f1429783175e6dab05b351",
    "case_total" : 0,
    "execd_total" : 0,
    "is_direct_relation" : false,
    "has_child" : false
  }, {
    "uri" : "v90200010p0d465u",
    "type" : "TestItem",
    "author" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
    "name" : "互联网出行行程检索解决方案验证",
    "region" : "roma-guian-2",
    "last_modifier" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
    "last_modified" : "2025-09-09 16:15:42",
    "last_modified_timestamp" : 1757405742000,
    "last_change_time" : "2025-09-09 16:15:42",
    "version_uri" : "v90100010p0crcjn",
    "parent_uri" : "v90100010p0crcjn",
    "parent_path" : "/3cb3c18b74f1429783175e6dab05b351/v90100010p0crcjn/",
    "creation_version_uri" : "v90100010p0crcjn",
    "creation_date" : "2025-09-09 16:15:42",
    "creation_date_timestamp" : 1757405742000,
    "is_feature" : "0",
    "relate_htsm" : "0",
    "project_uuid" : "3cb3c18b74f1429783175e6dab05b351",
    "case_total" : 0,
    "execd_total" : 0,
    "is_direct_relation" : false,
    "has_child" : false
  } ]
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

相关文档