文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试设计接口管理/ 根据节点Ids获取所有关联的用例对象
更新时间:2025-07-25 GMT+08:00
分享

根据节点Ids获取所有关联的用例对象

功能介绍

根据节点Ids获取所有关联的用例对象

调用方法

请参见如何调用API

URI

POST /v2/{project_id}/testcases/node-id

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目的32位uuid,项目唯一标识,通过获取CodeArts项目ID接口查询项目列表获取。

取值范围:

字符串长度32。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

必传。

取值范围:

字符串长度不少于1,不超过10万。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

params

TestCasePageParam object

参数解释:

用例分页参数

表4 TestCasePageParam

参数

是否必选

参数类型

描述

offset

Integer

参数解释:

起始偏移量,表示从此偏移量开始查询,offset大于等于0,小于等于100000

limit

Integer

参数解释:

每页显示的条目数量,最大支持200条

deleted

String

参数解释:

是否删除

取值范围:

  • 1,表示已删除

  • 0,表示未删除

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

参数解释:

是否归档

取值范围:

  • 0,表示未归档。

  • 1,表示已归档。

case_name

String

参数解释:

用例名称

取值范围:

大小写字母、数字、符号、中文。

长度限制1-10000位

has_sub_mindmap

Boolean

参数解释:

是否有子脑图

取值范围:

  • 0,表示无子脑图。

  • 1,表示有子脑图。

sub_mindmap_id

Array of strings

参数解释:

子脑图ID列表

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

code

String

参数解释:

错误码

取值范围:

大小写字母、数字。

长度限制0到20位

data

BasePageInfoTestCase object

参数解释:

返回体

取值范围:

不涉及

message

String

参数解释:

错误信息

取值范围:

大小写字母、数字、符号、中文。

长度限制0到1000位

表6 BasePageInfoTestCase

参数

参数类型

描述

limit

Integer

参数解释:

每页显示的条目数量,最大支持200条

取值范围:

数字,范围1到200。

list

Array of TestCase objects

参数解释:

返回体

取值范围:

不涉及

offset

Integer

参数解释:

起始偏移量,表示从此偏移量开始查询,offset大于等于0,小于等于100000

取值范围:

数字,范围0-100000。

pages

Integer

参数解释:

总页数量

取值范围:

数字,范围1-100。

size

Integer

参数解释:

列表个数

取值范围:

数字,范围1-200。

total

Long

参数解释:

总数

取值范围:

数字。

表7 TestCase

参数

参数类型

描述

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

参数解释:

是否归档

取值范围:

  • 0,表示未归档。

  • 1,表示已归档。

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

错误码

请参见错误码

相关文档