获取特性树 - ShowFeatureChildrenFive
功能介绍
此接口用于获取指定特性目录下的子集,根据传入的feature_uri,获取节点下的子目录数据
调用方法
请参见如何调用API。
URI
POST /v5/features/{feature_uri}/children
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| feature_uri | 是 | String | 特性uri |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| owner | 否 | String | 参数解释: 责任人,用于筛选指定责任人下的子特性 约束限制: 不涉及 取值范围: 1-128中英文、数字字符 默认取值: 无 |
| stage | 否 | String | 参数解释: 阶段,用于筛选指定测试阶段下的子特性 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| activity | 否 | String | 参数解释: 活动,用于筛选指定测试活动下的子特性 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| version_uri | 否 | String | 参数解释: 版本URI,用于筛选指定版本下的子特性。获取方式请参见获取版本URI接口 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| task_uri | 否 | String | 参数解释: 任务uri,用于筛选指定测试任务下的子特性。获取方式请参见查询测试任务列表接口 约束限制: 不涉及 取值范围: 字符串类型,长度为11-34位的字母或数字 默认取值: 不涉及 |
| service_type | 否 | String | 参数解释: 用例服务类型 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| contain_total | 否 | Boolean | 参数解释: 是否包含用例数 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| project_uuid | 是 | String | 参数解释 项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID 约束限制 不涉及 取值范围 项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字 默认取值 不涉及 |
| sort_type | 否 | String | 参数解释: 排序类型 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| page_number | 否 | Integer | 参数解释: 页码,用于指定查询结果的页码 约束限制: 不涉及 取值范围: 大于等于1的正整数 默认取值: 无 |
| page_size | 否 | Integer | 参数解释: 每页数量,用于指定每页返回的子特性数量,单位:条 约束限制: 不涉及 取值范围: 大于等于1的正整数 默认取值: 无 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | Integer | 参数解释 符合条件的所有记录数 取值范围 起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值 |
| value | Array of TestItemVo objects | 参数解释: 本次查询的记录结果 取值范围: 实际的数据类型:单个对象,集合 或 NULL |
| reason | String | 参数解释: 业务失败的提示内容 取值范围: 不涉及 |
| page_size | Integer | 参数解释: 每页展示条数 取值范围: 不涉及 |
| page_no | Integer | 参数解释: 页码 取值范围: 不涉及 |
| has_more | Boolean | 参数解释: 是否有更多 取值范围: true:是 false:否 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| uri | String | 参数解释: 资源URI 取值范围: 11-34位的字母及数字(字符串) |
| type | String | 参数解释: 资源类型 取值范围: |
| 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 | 参数解释: 是否特性 取值范围: |
| relate_htsm | String | 参数解释: 是否关联特性 取值范围: |
| 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 | 参数解释: 是否为直接关联 取值范围: |
| has_child | Boolean | 参数解释: 是否有子特性 取值范围: true:是 false:否 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码:404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 |
错误码
请参见错误码。