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

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

功能介绍

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

调用方法

请参见如何调用API。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

page_no

是

Integer

页码

page_size

是

Integer

每页数量

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

result

QueryProjectIssuesRelationTestCasesVo object

请求返回的数据

表4 QueryProjectIssuesRelationTestCasesVo

参数

参数类型

描述

test_case_num

Integer

需求关联的用例数量

testcases

Array of TestCaseVo objects

用例详情

total_count

Integer

用例总数

page_no

Integer

页码

page_size

Integer

每页数量

表5 TestCaseVo

参数

参数类型

描述

uri

String

参数解释

资源URI

取值范围

不涉及

type

String

参数解释:

资源类型

取值范围:

  • TestCase，用例。

  • Task，任务。

  • TestVersion，分支。

  • IteratorTestCase，迭代用例。

author

String

参数解释

创建人

取值范围

不涉及

name

String

参数解释

名称

取值范围

不涉及

rank

Integer

参数解释

级别

取值范围

不涉及

preparation

String

参数解释

前置条件

取值范围

不涉及

remark

String

参数解释

备注

取值范围

不涉及

stage

String

参数解释

测试阶段

取值范围

不涉及

activity

String

参数解释

测试类型

取值范围

不涉及

keywords

String

参数解释

关键词

取值范围

不涉及

market

String

参数解释

apitest标记是否代码已提交

取值范围

不涉及

designer

String

参数解释

设计者

取值范围

不涉及

tags

String

参数解释

标签

取值范围

不涉及

execute_parameter

String

参数解释

执行参数

取值范围

不涉及

region

String

参数解释

逻辑region

取值范围

不涉及

owner

String

参数解释

处理人id，IteratorTestCase字段

取值范围

不涉及

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

参数解释

编号

取值范围

不涉及

case_type

Integer

参数解释:

用例类型

约束限制:

不涉及

取值范围:

  • 0，手工测试。

  • 1，接口自动化。

  • 2，性能用例。

默认取值:

不涉及

platform_type

Integer

参数解释

执行平台类型

取值范围

不涉及

service_type

Integer

参数解释:

服务类型

约束限制:

不涉及

取值范围:

  • -1，全量用例。

  • 0，手工测试。

  • 1，接口自动化。

  • 7，功能自动化。

  • 8，WebUI自动化。

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

  • 11，性能自动化。

默认取值:

不涉及

service_type_name

String

参数解释

服务类型名称

取值范围

不涉及

test_type

Integer

参数解释:

测试类型

取值范围:

  • 1，性能。

  • 2，安全。

  • 3，功能。

  • 4，韧性可靠性。

  • 5，过载场景。

默认取值:

不涉及

test_type_name

String

参数解释

测试类型名称

取值范围

不涉及

design_note

String

参数解释

设计描述

取值范围

不涉及

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

参数解释

最后执行时间

取值范围

不涉及

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

错误码

请参见错误码。

父主题：外部服务管理

相关文档