文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 外部服务管理/ 查询项目下关联了需求的用例列表 - ShowProjectIssuesRelationTestCases
更新时间:2026-06-12 GMT+08:00
分享

查询项目下关联了需求的用例列表 - ShowProjectIssuesRelationTestCases

功能介绍

此接口用于查询项目下关联了需求的用例列表, 同页面 测试 -> 测试用例 -> 左侧点击需求目录 -> 查看右侧列表

调用方法

请参见如何调用API

URI

POST /v4/testhub/projects/{project_id}/issues/testcases/batch-query

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目UUID

约束限制

32位字母及数字

取值范围

项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

默认取值

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

page_no

Integer

参数解释

页码

约束限制

说明:
0 的正整数

取值范围

大于0小于100

默认取值

不涉及

page_size

Integer

参数解释

每页数量

约束限制

说明:
0 的正整数

取值范围

大于0小于20000

默认取值

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

result

QueryProjectIssuesRelationTestCasesVo object

请求返回的数据

表4 QueryProjectIssuesRelationTestCasesVo

参数

参数类型

描述

test_case_num

Integer

参数解释

需求关联的用例数量

取值范围

大于0的正整数

testcases

Array of TestCaseVo objects

参数解释

用例详情集合

取值范围

返回用例详情TestCaseVo数据

total_count

Integer

参数解释

用例总数

取值范围

大于0的正整数

page_no

Integer

参数解释

页码

取值范围

大于0小于100

page_size

Integer

参数解释

每页数量

取值范围

大于0小于20000

表5 TestCaseVo

参数

参数类型

描述

uri

String

参数解释

用例URI

取值范围

11-34位字母及数字

type

String

参数解释:

资源类型

取值范围:

  • TestCase,用例。

  • Task,任务。

  • TestVersion,分支。

  • IteratorTestCase,迭代用例。

author

String

参数解释

创建人

取值范围

长度1-128字符

name

String

参数解释

名称

取值范围

长度1-128字符

rank

Integer

参数解释

用例等级

取值范围

  • 0,Priority 0。

  • 1,Priority 1。

  • 2,Priority 2。

  • 3,Priority 3。

  • 4,Priority 4。

preparation

String

参数解释

前置条件

取值范围

长度1-128字符

remark

String

参数解释

备注

取值范围

长度1-128字符

stage

String

参数解释

测试阶段

取值范围

不涉及

activity

String

参数解释

测试类型

取值范围

长度1-128字符

keywords

String

参数解释

关键词

取值范围

长度1-128字符

market

String

参数解释

apitest标记是否代码已提交

取值范围

长度1-128字符

designer

String

参数解释

设计者

取值范围

长度1-128字符

tags

String

参数解释

标签

取值范围

长度1-128字符

execute_parameter

String

参数解释

执行参数

取值范围

长度1-128字符

region

String

参数解释

逻辑region

取值范围

长度1-128字符

owner

String

参数解释

处理人id,IteratorTestCase字段

取值范围

长度1-128字符

last_modifier

String

参数解释

最后修改人

取值范围

长度1-128字符

last_modified

String

参数解释

最后修改时间

取值范围

长度1-128字符

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

参数解释

创建时间

取值范围

时间格式为"yyyy-MM-dd HH:mm:ss"

creation_date_timestamp

Long

参数解释

创建时间时间戳

取值范围

时间戳格式,单位为毫秒

author_name

String

参数解释

创建人名称

取值范围

长度1-128字符

comment

String

参数解释

备注

取值范围

长度1-128字符

number

String

参数解释

编号

取值范围

长度1-128字符

case_type

Integer

参数解释:

用例类型

约束限制:

不涉及

取值范围:

  • 0,手工测试。

  • 1,接口自动化。

  • 2,性能用例。

默认取值:

不涉及

platform_type

Integer

参数解释

执行平台类型

取值范围

不涉及

service_type

Integer

参数解释:

服务类型

约束限制:

不涉及

取值范围:

  • -1,全量用例。

  • 0,手工测试。

  • 1,接口自动化。

  • 7,功能自动化。

  • 8,WebUI自动化。

  • 100,自定义自动化(工厂)。

  • 11,性能自动化。

默认取值:

不涉及

service_type_name

String

参数解释

服务类型名称

取值范围

长度1-128字符

test_type

Integer

参数解释:

测试类型

取值范围:

  • 1,性能。

  • 2,安全。

  • 3,功能。

  • 4,韧性可靠性。

  • 5,过载场景。

默认取值:

不涉及

test_type_name

String

参数解释

测试类型名称

取值范围

长度1-128字符

design_note

String

参数解释

设计描述

取值范围

长度1-128字符

test_step

String

参数解释

测试步骤

取值范围

不涉及

expect_output

String

参数解释

期望结果

取值范围

不涉及

env_type

String

参数解释

测试环境类型

取值范围

不涉及

exe_platform

String

参数解释

执行平台

取值范围

不涉及

testcase_project

String

参数解释

测试工程

取值范围

不涉及

svn_script_path

String

参数解释

脚本路径

取值范围

不涉及

map_restrict

String

参数解释

约束条件

取值范围

不涉及

network_script_name

String

参数解释

网络脚本名

取值范围

不涉及

auto_type

Integer

参数解释:

自动化类型

约束限制:

不涉及

取值范围:

  • 0,非自动化。

  • 1,是自动化。

默认取值:

不涉及

to_be_auto_exec

Integer

参数解释

被自动化执行

取值范围

不涉及

last_result

String

参数解释

最后一次结果

取值范围

不涉及

last_result_uri

String

参数解释

最后一次结果Uri

取值范围

不涉及

feature_uri

String

参数解释

目录Uri

取值范围

不涉及

feature_name

String

参数解释

目录名称

取值范围

不涉及

interface_name

String

参数解释

测试接口名

取值范围

不涉及

snp_no

String

参数解释

网络问题ID

取值范围

不涉及

dr_relation_id

String

参数解释

关联需求编号

取值范围

不涉及

issue_name

String

参数解释

需求名称

取值范围

不涉及

test_base_num

String

参数解释

测试基数

取值范围

不涉及

automatically_executed

Integer

参数解释

是否被自动化执行

取值范围

不涉及

first_execute_time

String

参数解释

第一次执行时间

取值范围

不涉及

detect_type

String

参数解释

检测类型

取值范围

不涉及

execute_param

String

参数解释

执行参数

取值范围

不涉及

test_feature

String

参数解释

分析领域

取值范围

不涉及

is_contract_testcase

Integer

参数解释

是否是契约用例

取值范围

0:表示非契约用例, 1:表示契约用例

time_cost

Double

参数解释

总共耗时

取值范围

不涉及

be_auto_type_time

String

参数解释

记录用例由非自动化变为自动化类型的时间

取值范围

不涉及

compare_number

String

参数解释

配对用例编号

取值范围

不涉及

scene_flag

String

参数解释

场景标识

取值范围

不涉及

base_flag

String

参数解释

场景标识

取值范围

不涉及

para_validator

String

参数解释

区别是否从yaml中生成的用例

取值范围

默认false

knet_node_id

String

参数解释

knet节点id

取值范围

不涉及

last_exe_author

String

参数解释

最后一次执行用户

取值范围

不涉及

cloud_carrier

String

参数解释

运营商

取值范围

不涉及

market_place

String

参数解释

应用市场

取值范围

不涉及

test_mind_id

String

参数解释

脑图id

取值范围

不涉及

test_mind_url

String

参数解释

脑图url

取值范围

不涉及

commit_url

String

参数解释

git提交url

取值范围

不涉及

test_pattern_number

String

参数解释

测试模式编号

取值范围

不涉及

test_factor_number

String

参数解释

测试因子编号

取值范围

不涉及

status_code

String

参数解释

状态Code

取值范围

不涉及

result_code

String

参数解释

结果Code

取值范围

不涉及

release_id

String

参数解释

迭代ID

取值范围

不涉及

label_id

String

参数解释

标签ID

取值范围

不涉及

labels

String

参数解释

用例标签名称列表

取值范围

不涉及

module_id

String

参数解释

模块ID

取值范围

不涉及

module_name

String

参数解释

模块名称

取值范围

不涉及

module_path

String

参数解释

模块path

取值范围

不涉及

module_path_name

String

参数解释

模块路径名称

取值范围

不涉及

execute_latest_time

String

参数解释

最后执行时间

取值范围

格式为yyyy-MM-dd HH:mm:ss

execute_duration

String

参数解释

执行时长,单位(毫秒)

取值范围

不涉及

execute_times

Integer

参数解释

执行次数

取值范围

不涉及

is_keyword

Integer

参数解释

是否关键用例

取值范围

不涉及

release_dev

String

参数解释

测试版本号

取值范围

不涉及

new_created

String

参数解释

是否用户新增用例

取值范围

不涉及

project_uuid

String

参数解释

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

取值范围

长度等于32位,包含大小写字母、数字

creation_version_name

String

参数解释

创建版本名称,原逻辑marshall添加字段

取值范围

不涉及

feature_path

String

参数解释

特性路径,原逻辑marshall添加字段

取值范围

不涉及

testcase_uri

String

参数解释

实体用例Uri,IteratorTestCase字段

取值范围

不涉及

owner_name

String

参数解释

处理人名称

取值范围

不涉及

iterator_case_uri

String

参数解释

迭代用例Uri,IteratorTestCase字段

取值范围

不涉及

script_link

String

参数解释

脚本链接scriptLink

取值范围

不涉及

test_step_model

String

参数解释

测试步骤模式

取值范围

text: 文本模式; table: 表格模式

custom_field_1

String

参数解释

自定义字段1

取值范围

不涉及

custom_field_2

String

参数解释

自定义字段2

取值范围

不涉及

custom_field_3

String

参数解释

自定义字段3

取值范围

不涉及

custom_field_4

String

参数解释

自定义字段4

取值范围

不涉及

custom_field_5

String

参数解释

自定义字段5

取值范围

不涉及

custom_field_6

String

参数解释

自定义字段6

取值范围

不涉及

custom_field_7

String

参数解释

自定义字段7

取值范围

不涉及

custom_field_8

String

参数解释

自定义字段8

取值范围

不涉及

custom_field_9

String

参数解释

自定义字段9

取值范围

不涉及

custom_field_10

String

参数解释

自定义字段10

取值范围

不涉及

custom_field_11

String

参数解释

自定义字段11

取值范围

不涉及

custom_field_12

String

参数解释

自定义字段12

取值范围

不涉及

custom_field_13

String

参数解释

自定义字段13

取值范围

不涉及

custom_field_14

String

参数解释

自定义字段14

取值范围

不涉及

custom_field_15

String

参数解释

自定义字段15

取值范围

不涉及

custom_field_16

String

参数解释

自定义字段16

取值范围

不涉及

custom_field_17

String

参数解释

自定义字段17

取值范围

不涉及

custom_field_18

String

参数解释

自定义字段18

取值范围

不涉及

custom_field_19

String

参数解释

自定义字段19

取值范围

不涉及

custom_field_20

String

参数解释

自定义字段20

取值范围

不涉及

custom_field_21

String

参数解释

自定义字段21

取值范围

不涉及

custom_field_22

String

参数解释

自定义字段22

取值范围

不涉及

custom_field_23

String

参数解释

自定义字段23

取值范围

不涉及

custom_field_24

String

参数解释

自定义字段24

取值范围

不涉及

custom_field_25

String

参数解释

自定义字段25

取值范围

不涉及

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:401

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:500

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

post https://{endpoint}/v4/testhub/projects/c4e36f20d35a4720a1647e8e6215b737/issues/testcases/batch-query

{
  "page_no" : 1,
  "page_size" : 10
}

响应示例

状态码:200

OK

{
  "test_case_num" : 0,
  "total_count" : 0,
  "page_no" : 1,
  "page_size" : 10
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档