搜索用例的特性树 - 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

{
  "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
  }
}