获取目录
功能介绍
获取目录
URI
POST /GT3KServer/v4/features/{feature_id}/children
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
feature_id |
是 |
String |
特性目录ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) 约束限制 不涉及 取值范围 字符串长度不少于1,不超过100000 默认取值 不涉及 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
owner |
否 |
String |
责任人 |
stage |
否 |
String |
阶段 |
activity |
否 |
String |
活动 |
version_uri |
否 |
String |
版本URI |
task_uri |
否 |
String |
任务uri |
service_type |
否 |
String |
用例服务类型 |
contain_total |
否 |
Boolean |
是否包含用例数 |
project_uuid |
否 |
String |
项目id |
sort_type |
否 |
String |
排序类型 |
page_number |
否 |
Integer |
页码 |
page_size |
否 |
Integer |
每页数量 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
status |
String |
success|error |
result |
ResultValueListTestItemVo object |
请求的返回的数据对象 |
error |
ApiError object |
失败时的error信息 |
request_id |
String |
由接口调用方传入,建议使用UUID保证请求的唯一性。 |
server_address |
String |
本次请求的受理的服务地址。 |
参数 |
参数类型 |
描述 |
---|---|---|
total |
Integer |
起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值 |
value |
Array of TestItemVo objects |
实际的数据类型:单个对象,集合 或 NULL |
reason |
String |
业务失败的提示内容 |
page_size |
Integer |
每页展示条数 |
page_no |
Integer |
页码 |
has_more |
Boolean |
是否有更多 |
参数 |
参数类型 |
描述 |
---|---|---|
uri |
String |
资源URI |
type |
String |
资源类型 |
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_uuid |
String |
项目id |
case_total |
Integer |
用例总数 |
execd_total |
Integer |
执行总数 |
is_direct_relation |
Boolean |
is_direct_relation |
has_child |
Boolean |
是否有子特性 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
参数解释: 业务失败的错误码 取值范围: 不涉及 |
reason |
String |
参数解释: 业务失败的提示内容 取值范围: 不涉及 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
参数解释: 业务失败的错误码 取值范围: 不涉及 |
reason |
String |
参数解释: 业务失败的提示内容 取值范围: 不涉及 |
状态码:404
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
参数解释: 业务失败的错误码 取值范围: 不涉及 |
reason |
String |
参数解释: 业务失败的提示内容 取值范围: 不涉及 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
参数解释: 业务失败的错误码 取值范围: 不涉及 |
reason |
String |
参数解释: 业务失败的提示内容 取值范围: 不涉及 |
请求示例
POST https://{endpoint}/GT3KServer/v4/features/{feature_id}/children
{
"project_uuid" : "b318f1f3fcef44dd8d549c3624ea8955",
"version_uri" : "v90j0001004q3pfj",
"contain_total" : true,
"sort_type" : "asc"
}
响应示例
状态码:200
OK
{
"result" : {
"value" : [ {
"uri" : "v90100010b7rs990",
"type" : "TestItem",
"author" : "85f7cd3cd8784307a5bb194321bef3c1",
"name" : "新增子目录(1)",
"last_modifier" : "85f7cd3cd8784307a5bb194321bef3c1",
"last_modified" : "2025-03-22 14:08:27",
"last_modified_timestamp" : 1742623707424,
"last_change_time" : "2025-03-22 14:08:27",
"version_uri" : "v901000106dij34m",
"parent_uri" : "v901000107pbs1bc",
"parent_path" : "/761e569574894180b3ecadc9d9df52b6/v901000106dij34m/v901000107pbs1bc/",
"creation_version_uri" : "v901000106dij34m",
"creation_date" : "2025-03-22 14:08:27",
"creation_date_timestamp" : 1742623707424,
"is_feature" : "0",
"relate_htsm" : "0",
"project_uuid" : "761e569574894180b3ecadc9d9df52b6",
"case_total" : 1,
"execd_total" : 0,
"is_direct_relation" : true,
"has_child" : false
} ]
}
}
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Not Found |
500 |
Internal Server Error |
错误码
请参见错误码。