文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试用例管理/ 在分支或者迭代下创建用例
更新时间:2025-07-24 GMT+08:00
分享

在分支或者迭代下创建用例

功能介绍

在分支或者迭代下创建用例

调用方法

请参见如何调用API

URI

POST /v4/versions/{version_uri}/testcases

表1 路径参数

参数

是否必选

参数类型

描述

version_uri

String

分支或者迭代uri

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

steps

Array of TestCaseStepInfo objects

参数解释:

测试步骤

约束限制:

不涉及

取值范围:

0-100

默认取值:

不涉及

attachments

Array of TestCaseAttachmentInfo objects

参数解释:

附件

约束限制:

不涉及

取值范围:

0-100

默认取值:

不涉及

author

String

参数解释

创建人

约束限制

1-32个英文或者数字

取值范围

不涉及

默认取值

不涉及

name

String

参数解释

名称

约束限制

长度限制128字符

取值范围

不涉及

默认取值

不涉及

rank

Integer

参数解释

用例等级

约束限制

不涉及

取值范围

取值范围:0,1,2,3,4

默认取值

不涉及

owner

String

参数解释

处理人

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

preparation

String

参数解释

前置条件

约束限制

长度限制3000字符

取值范围

不涉及

默认取值

不涉及

remark

String

参数解释

备注

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

stage

String

参数解释

测试阶段

约束限制

长度限制50字符

取值范围

不涉及

默认取值

不涉及

activity

String

参数解释

测试类型

约束限制

长度限制64字符

取值范围

不涉及

默认取值

不涉及

keywords

String

参数解释

关键词

约束限制

长度限制512字符

取值范围

不涉及

默认取值

不涉及

market

String

参数解释

apitest标记是否代码已提交

约束限制

长度限制1024字符

取值范围

不涉及

默认取值

不涉及

designer

String

参数解释

设计者

约束限制

长度限制64字符

取值范围

不涉及

默认取值

不涉及

tags

String

参数解释

标签

约束限制

长度限制512字符

取值范围

不涉及

默认取值

不涉及

region

String

参数解释

逻辑region,外部使用公有云实际区域,内部使用默认值

约束限制

长度限制32字符

取值范围

不涉及

默认取值

不涉及

relate_type

String

参数解释

关联资源类型

约束限制

不涉及

取值范围

取值范围:requirement|bug

默认取值

不涉及

service_type

Integer

参数解释

服务类型

约束限制

1到7位数字

取值范围

不涉及

默认取值

不涉及

only_change_script

String

参数解释

更新接口用例的java脚本路径标识

约束限制

长度限制32字符

取值范围

不涉及

默认取值

不涉及

add_to_iterator

String

参数解释

需求添加到迭代标识

约束限制

长度限制5字符

取值范围

不涉及

默认取值

不涉及

need_update_relation

String

参数解释

是否修改关联关系

约束限制

长度限制5字符

取值范围

不涉及

默认取值

不涉及

creation_version_uri

String

参数解释

创建版本Uri

约束限制

11到34位英文或数字

取值范围

不涉及

默认取值

不涉及

number

String

参数解释

用例编号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

case_type

Integer

参数解释

用例类型

约束限制

不涉及

取值范围

取值范围:-128-127

默认取值

不涉及

platform_type

Integer

参数解释

执行平台类型

约束限制

不涉及

取值范围

取值范围:-128-127

默认取值

不涉及

test_type

Integer

参数解释

测试类型

约束限制

不涉及

取值范围

取值范围:-128-127

默认取值

不涉及

design_note

String

参数解释

设计描述

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

test_step

String

参数解释

测试步骤

约束限制

长度限制250000字符

取值范围

不涉及

默认取值

不涉及

expect_output

String

参数解释

期望结果

约束限制

长度限制250000字符

取值范围

不涉及

默认取值

不涉及

env_type

String

参数解释

测试环境类型

约束限制

长度限制512字符

取值范围

不涉及

默认取值

不涉及

exe_platform

String

参数解释

执行平台

约束限制

长度限制200字符

取值范围

不涉及

默认取值

不涉及

testcase_project

String

参数解释

测试工程

约束限制

长度限制1024字符

取值范围

不涉及

默认取值

不涉及

svn_script_path

String

参数解释

脚本路径

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

map_restrict

String

参数解释

约束条件

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

network_script_name

String

参数解释

网络脚本名

约束限制

长度限制500字符

取值范围

不涉及

默认取值

不涉及

auto_type

Integer

参数解释

自动化类型,非自动化:0, 是自动化:1

约束限制

长度限制500字符

取值范围

取值范围:0,1

默认取值

不涉及

to_be_auto_exec

Integer

参数解释

被自动化执行

约束限制

不涉及

取值范围

-128-127

默认取值

不涉及

last_result

String

参数解释

最后一次结果

约束限制

长度限制16字符

取值范围

不涉及

默认取值

不涉及

last_result_uri

String

参数解释

最后一次结果Uri

约束限制

不涉及

取值范围

11-34位数字或英文

默认取值

不涉及

feature_uri

String

参数解释

目录Uri

约束限制

不涉及

取值范围

11-34位数字或英文

默认取值

不涉及

interface_name

String

参数解释

测试接口名

约束限制

长度限制200字符

取值范围

不涉及

默认取值

不涉及

snp_no

String

参数解释

网络问题ID

约束限制

长度限制500字符

取值范围

不涉及

默认取值

不涉及

dr_relation_id

String

参数解释

关联需求编号

约束限制

不涉及

取值范围

1-32位数字

默认取值

不涉及

test_base_num

String

参数解释

测试基数

约束限制

长度限制200字符

取值范围

不涉及

默认取值

不涉及

automatically_executed

Integer

参数解释

是否被自动化执行

约束限制

不涉及

取值范围

-128-127

默认取值

不涉及

first_execute_time

String

参数解释

第一次执行时间

约束限制

d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}

取值范围

不涉及

默认取值

不涉及

detect_type

String

参数解释

检测类型

约束限制

长度限制100字符

取值范围

不涉及

默认取值

不涉及

execute_param

String

参数解释

执行参数

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

test_feature

String

参数解释

分析领域

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

is_contract_testcase

Integer

参数解释

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

约束限制

不涉及

取值范围

0,1

默认取值

不涉及

time_cost

Double

参数解释

总共耗时

约束限制

不涉及

取值范围

2147483648.44-2147483647.44

默认取值

不涉及

custom_field_1

String

参数解释

自定义字段1

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_2

String

参数解释

自定义字段2

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_3

String

参数解释

自定义字段3

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_4

String

参数解释

自定义字段4

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_5

String

参数解释

自定义字段5

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_6

String

参数解释

自定义字段6

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_7

String

参数解释

自定义字段7

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_8

String

参数解释

自定义字段8

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_9

String

参数解释

自定义字段9

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_10

String

参数解释

自定义字段10

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_11

String

参数解释

自定义字段11

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_12

String

参数解释

自定义字段12

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_13

String

参数解释

自定义字段13

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_14

String

参数解释

自定义字段14

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_15

String

参数解释

自定义字段15

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_16

String

参数解释

自定义字段16

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_17

String

参数解释

自定义字段17

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_18

String

参数解释

自定义字段18

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_19

String

参数解释

自定义字段19

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_20

String

参数解释

自定义字段20

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_21

String

参数解释

自定义字段21

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_22

String

参数解释

自定义字段22

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_23

String

参数解释

自定义字段23

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_24

String

参数解释

自定义字段24

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

custom_field_25

String

参数解释

自定义字段25

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

be_auto_type_time

String

参数解释

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

约束限制

d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}

取值范围

不涉及

默认取值

不涉及

compare_number

String

参数解释

配对用例编号

约束限制

长度限制100字符

取值范围

不涉及

默认取值

不涉及

scene_flag

String

参数解释

场景标识

约束限制

长度限制50字符

取值范围

不涉及

默认取值

不涉及

base_flag

String

参数解释

场景标识

约束限制

长度限制50字符

取值范围

不涉及

默认取值

不涉及

para_validator

String

参数解释

区别是否从yaml中生成的用例,默认false

约束限制

长度限制50字符

取值范围

不涉及

默认取值

false

knet_node_id

String

参数解释

knet节点id

约束限制

长度限制50字符

取值范围

不涉及

默认取值

不涉及

last_exe_author

String

参数解释

最后一次执行用户

约束限制

长度限制50字符

取值范围

不涉及

默认取值

不涉及

cloud_carrier

String

参数解释

运营商

约束限制

长度限制100字符

取值范围

不涉及

默认取值

不涉及

market_place

String

参数解释

应用市场

约束限制

长度限制1024字符

取值范围

不涉及

默认取值

不涉及

test_mind_id

String

参数解释

脑图id

约束限制

长度限制256字符

取值范围

不涉及

默认取值

不涉及

test_mind_url

String

参数解释

脑图url

约束限制

长度限制1024字符

取值范围

不涉及

默认取值

不涉及

commit_url

String

参数解释

git提交url

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

test_pattern_number

String

参数解释

测试模式编号

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

test_factor_number

String

参数解释

测试因子编号

约束限制

长度限制65535字符

取值范围

不涉及

默认取值

不涉及

status_code

String

参数解释

状态Code

约束限制

[-]?[0-9]{1,5}

取值范围

不涉及

默认取值

不涉及

result_code

String

参数解释

测试因子编号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

release_id

String

参数解释

迭代ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

label_id

String

参数解释

标签ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

label_names

Array of strings

参数解释

用例操作时,标签名列表

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

module_id

String

参数解释

模块ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

execute_latest_time

String

参数解释

最后执行时间

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

execute_duration

String

参数解释

执行时长

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

is_keyword

Integer

参数解释

是否关键用例

约束限制

不涉及

取值范围

-128-127

默认取值

不涉及

release_dev

String

参数解释

测试版本号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

new_created

Integer

参数解释

是否用户新增用例

约束限制

不涉及

取值范围

-128-127

默认取值

不涉及

execute_parameter

String

参数解释

执行参数

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

project_uuid

String

参数解释

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

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

version_uri

String

参数解释

分支或者迭代uri

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表3 TestCaseStepInfo

参数

是否必选

参数类型

描述

test_step

String

参数解释

测试步骤

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

expect_result

String

参数解释

预期结果

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

step_actual

String

参数解释

步骤的实际结果

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

step_result

String

参数解释

步骤结果

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表4 TestCaseAttachmentInfo

参数

是否必选

参数类型

描述

override

Boolean

参数解释

附件是否要被覆盖

约束限制

不涉及

取值范围

true|false

默认取值

不涉及

doc_id

String

参数解释

文档id

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

file_name

String

参数解释

文件名

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

file_path

String

参数解释

文件路径

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

file_type

String

参数解释

文件类型

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

file_size

String

参数解释

文件大小

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

override_id

String

参数解释

重复用例ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

related_type

String

参数解释

相关类型

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

store_file_name

String

参数解释

保存文件名

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

system_type

String

参数解释

系统区分

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

storage_system

String

参数解释

区分文件存储系统

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

status

String

参数解释:

本次请求的处理状态

取值范围:

success|error

result

ResultValueTestCaseVo object

参数解释:

请求返回的结果

取值范围:

不涉及

error

ApiError object

参数解释:

错误信息

取值范围:

不涉及

request_id

String

参数解释:

由接口调用方传入,建议使用UUID保证请求的唯一性。

取值范围:

不涉及

server_address

String

参数解释:

本次请求的受理的服务地址

取值范围:

不涉及

表6 ResultValueTestCaseVo

参数

参数类型

描述

total

Integer

参数解释:

符合条件的所有记录数

取值范围:

起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值

value

TestCaseVo object

参数解释

实际的数据类型

取值范围

单个对象,集合 或 NULL

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

page_size

Integer

参数解释:

每页展示条数

取值范围:

1-100

page_no

Integer

参数解释:

页码

取值范围:

1-20000

has_more

Boolean

参数解释:

是否有更多

取值范围:

true:有更多 false:无更多

表7 TestCaseVo

参数

参数类型

描述

uri

String

参数解释

资源URI

取值范围

不涉及

type

String

参数解释

资源类型

取值范围

不涉及

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

参数解释

父资源路径

取值范围

不涉及用例类型

platform_type

Integer

参数解释

执行平台类型

取值范围

不涉及

service_type

Integer

参数解释

服务类型

取值范围

不涉及

service_type_name

String

参数解释

服务类型名称

取值范围

不涉及

test_type

Integer

参数解释

测试类型

取值范围

不涉及

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

参数解释

自定义字段26

取值范围

不涉及

表8 ApiError

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码:400

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:401

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:404

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:500

表12 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

post https://{endpoint}/v4/versions/v92t00010g2edrt1/testcases?_=1750321884367

{
  "project_uuid" : "db9851fc9d09438c8577f90fd7915ade",
  "version_uri" : "v92t00010g2edrt1",
  "service_type" : 0,
  "relate_type" : "requirement",
  "name" : "111",
  "remark" : "",
  "preparation" : "",
  "svn_script_path" : "",
  "steps" : [ {
    "test_step" : "",
    "expect_result" : ""
  } ],
  "number" : "",
  "rank" : 2,
  "module_id" : "",
  "release_dev" : "",
  "release_id" : "",
  "owner" : "",
  "test_type" : 1,
  "label_names" : [ ],
  "dr_relation_id" : "",
  "exe_platform" : "",
  "testcase_project" : "",
  "network_script_name" : "",
  "attachments" : [ ]
}

响应示例

状态码:200

OK

{
  "status" : "success",
  "result" : {
    "value" : {
      "uri" : "v92s00010id9e09t",
      "type" : "TestCase",
      "author" : "cba378b8db4f4b6da3a5f01abd68ebe6",
      "name" : "111",
      "rank" : 2,
      "stage" : "1",
      "designer" : "cba378b8db4f4b6da3a5f01abd68ebe6",
      "region" : "cn-north-7",
      "owner" : "",
      "last_modifier" : "cba378b8db4f4b6da3a5f01abd68ebe6",
      "last_modified" : "2025-06-19 16:31:24",
      "last_change_time" : "2025-06-19 16:31:24",
      "version_uri" : "v92s00010g2ebga6",
      "parent_uri" : "v92s00010g2ebga6",
      "parent_path" : "/db9851fc9d09438c8577f90fd7915ade/v92s00010g2ebga6/",
      "creation_version_uri" : "v92s00010g2ebga6",
      "creation_date" : "2025-06-19 16:31:24",
      "number" : "108",
      "case_type" : 0,
      "platform_type" : 0,
      "service_type" : 0,
      "test_type" : 1,
      "test_step" : "[\"\"]",
      "expect_output" : "[\"\"]",
      "auto_type" : 0,
      "to_be_auto_exec" : 0,
      "automatically_executed" : 0,
      "is_contract_testcase" : 0,
      "time_cost" : 0,
      "status_code" : "0",
      "execute_times" : 0,
      "project_uuid" : "db9851fc9d09438c8577f90fd7915ade",
      "creation_version_name" : "基线"
    }
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档