根据节点Ids获取所有关联的用例对象 - ShowTestCasesByNodeIds
功能介绍
根据脑图节点Id列表获取所有关联的用例对象
调用方法
请参见如何调用API。
URI
POST /v2/{project_id}/testcases/node-id
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 参数解释: 项目的32位uuid,项目唯一标识,通过获取CodeArts项目ID接口查询项目列表获取。 取值范围: 字符串长度32。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 必传。 取值范围: 字符串长度不少于1,不超过10万。 默认取值: 不涉及。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
params | 是 | TestCasePageParam object | 参数解释: 用例分页参数 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
offset | 否 | Integer | 参数解释: 起始偏移量,表示从此偏移量开始查询,offset大于等于0,小于等于100000 |
limit | 否 | Integer | 参数解释: 每页显示的条目数量,最大支持100条 |
deleted | 否 | String | 参数解释: 是否删除 取值范围:
|
id_collection | 否 | Array of strings | 参数解释: ID集合 |
mindmap_id | 否 | String | 参数解释: 脑图ID 取值范围: 大小写字母、数字。 长度限制固定32位 |
node_id | 否 | String | 参数解释: 节点ID 取值范围: 大小写字母、数字。 长度限制固定32位 |
node_id_collection | 否 | Array of strings | 参数解释: 节点ID集合 |
project_id | 否 | String | 参数解释: 项目ID 取值范围: 大小写字母、数字。 长度限制固定32位 |
is_archive | 否 | Boolean | 参数解释: 是否归档 取值范围:
|
case_name | 否 | String | 参数解释: 用例名称 取值范围: 大小写字母、数字、符号、中文。 长度限制1-10000位 |
has_sub_mindmap | 否 | Boolean | 参数解释: 是否有子脑图 取值范围:
|
sub_mindmap_id | 否 | Array of strings | 参数解释: 子脑图ID列表 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
code | String | 参数解释: 错误码 取值范围: 大小写字母、数字。 长度限制0到20位 |
data | BasePageInfoTestCase object | 参数解释: 返回体 取值范围: 不涉及 |
message | String | 参数解释: 错误信息 取值范围: 大小写字母、数字、符号、中文。 长度限制0到1000位 |
参数 | 参数类型 | 描述 |
|---|---|---|
limit | Integer | 参数解释: 每页显示的条目数量,最大支持100条 取值范围: 数字,范围1到100。 |
list | Array of TestCase objects | 参数解释: 返回体 取值范围: 不涉及 |
offset | Integer | 参数解释: 起始偏移量,表示从此偏移量开始查询,offset大于等于0,小于等于100000 取值范围: 数字,范围0-100000。 |
pages | Integer | 参数解释: 总页数量 取值范围: 数字,范围1-100。 |
size | Integer | 参数解释: 列表个数 取值范围: 数字,范围1-200。 |
total | Long | 参数解释: 总数 取值范围: 数字。 |
参数 | 参数类型 | 描述 |
|---|---|---|
auto_type | String | 参数解释: 自动化类型 取值范围: 大小写字母、数字、符号。 |
case_design_desc | String | 参数解释: 用例设计描述 取值范围: 大小写字母、数字、符号、中文。 |
case_name | String | 参数解释: 用例名称 取值范围: 大小写字母、数字、符号、中文。 长度限制1-10000位 |
case_num | String | 参数解释: 用例编号 取值范围: 大小写字母、数字、符号。 |
create_time | String | 参数解释: 创建时间 取值范围: 固定日期格式yyyy-MM-dd HH:mm:ss |
creator_name | String | 参数解释: 创建人名字 取值范围: 大小写字母、数字、符号、中文。 |
creator_num | String | 参数解释: 创建者,用户在IAM中的ID。 取值范围: 大小写字母、数字。 长度限制固定32位 |
deleted | String | 参数解释: 删除状态 取值范围: 大小写字母、数字、符号、中文。 |
expected_results | String | 参数解释: 预期结果 取值范围: 大小写字母、数字、符号、中文。 |
extra_param | String | 参数解释: 额外模板字段:以json形式存储,前台解析 取值范围: 大小写字母、数字、符号、中文。 |
factor_combination_json | String | 参数解释: 因子组合json 取值范围: 大小写字母、数字、符号、中文。 |
operation_and_expected_result | String | 参数解释: 操作及预期结果 取值范围: 大小写字母、数字、符号、中文。 |
id | String | 参数解释: id 主键 取值范围: 大小写字母、数字。 长度限制固定32位 |
is_archive | Boolean | 参数解释: 是否归档 取值范围:
|
mindmap_id | String | 参数解释: 脑图ID 取值范围: 大小写字母、数字。 长度限制固定32位 |
node_id | String | 参数解释: 节点ID 取值范围: 大小写字母、数字。 长度限制固定32位 |
batch_id | String | 参数解释: 批次id 取值范围: 大小写字母、数字。 长度限制固定32位 |
branch_id | String | 参数解释: 分支ID 取值范围: 大小写字母、数字。 |
plan_id | String | 参数解释: 计划ID 取值范围: 大小写字母、数字。 长度限制固定32位 |
prerequisite | String | 参数解释: 用例前置步骤 取值范围: 大小写字母、数字、符号、中文。 |
test_case_level | String | 参数解释: 测试用例级别 取值范围: 大小写字母、数字、符号、中文。 |
test_procedure | String | 参数解释: 测试步骤 取值范围: 大小写字母、数字、符号、中文。 |
update_name | String | 参数解释: 更新人名字 取值范围: 大小写字母、数字、符号、中文。 |
update_num | String | 参数解释: 更新人工号 取值范围: 大小写字母、数字。 |
update_time | String | 参数解释: 更新时间 取值范围: 固定日期格式yyyy-MM-dd HH:mm:ss |
url | String | 参数解释: url |
uri | String | 参数解释: uri 取值范围: 大小写字母、数字、符号。 |
project_id | String | 参数解释: 项目ID 取值范围: 大小写字母、数字。 长度限制固定32位 |
service_id | String | 参数解释: 服务id 取值范围: 大小写字母、数字。 长度限制固定32位 |
状态码:201
Created
请求示例
根据节点Ids获取所有关联的用例对象
post https://{endpoint}/v2/f70d0db4745c435aa7cd3dd81d8818e7/testcases/node-id
{
"params" : {
"is_archive" : true,
"mindmap_id" : "e581c00a1ead42d0b3bc1abb77fbbceb",
"node_id_collection" : [ ],
"offset" : 1,
"limit" : 10
}
} 响应示例
状态码:200
OK
{
"code" : "success",
"data" : {
"total" : 1,
"list" : [ {
"id" : "90FB499CE2BD469CA400A3A850FC2B9C",
"prerequisite" : "",
"url" : null,
"uri" : "v92u000105orl1l3",
"deleted" : "no",
"create_time" : "2025/01/13 14:55:27 GMT+08:00",
"creator_name" : "user",
"creator_num" : "efdb403066474ab08836b9eeaaa23bca",
"update_name" : "user",
"update_num" : "efdb403066474ab08836b9eeaaa23bca",
"update_time" : "2025/01/13 14:55:35 GMT+08:00",
"case_name" : "子主题",
"test_procedure" : "",
"expected_results" : "",
"operation_and_expected_result" : null,
"case_design_desc" : null,
"case_num" : null,
"auto_type" : "true",
"test_case_level" : "2",
"node_id" : "7B3E87D771504220A2B9C757E6AC42E1",
"mindmap_id" : "fb6bd82a6c084fdab0d8e5d8f820eabc",
"is_archive" : true,
"extra_param" : "{\"tcStatus\":\"archive\"}",
"project_id" : "76667cb543a14cacac2ade913ca44a47",
"factor_combination_json" : null,
"batch_id" : null,
"service_id" : "0",
"branch_id" : "v92s0001044h0a6b",
"plan_id" : ""
} ],
"offset" : 1,
"limit" : 50,
"pages" : 1,
"size" : 1
},
"message" : null
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
错误码
请参见错误码。

