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

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

功能介绍

此接口用于在测试计划或者分支下下创建用例,同页面 测试 -> 测试用例 -> 上方页签下拉列表选择分支或迭代 -> 点击创建用例

调用方法

请参见如何调用API。

URI

POST /v4/versions/{version_uri}/testcases

表1 路径参数

参数

是否必选

参数类型

描述

version_uri

是

String

分支或者迭代uri

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

case_uri

否

String

参数解释

用例的唯一标识URI,用于定位和更新指定用例

约束限制

长度限制32字符

取值范围

不涉及

默认取值

不涉及

attachments

否

Array of TestCaseAttachmentInfo objects

参数解释:

对外附件信息列表,每个元素为TestCaseAttachmentInfo对象,包含附件的文件名、路径、类型等信息

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

steps

否

Array of TestCaseStepInfo objects

参数解释:

测试步骤信息列表,每个元素为TestCaseStepInfo对象,包含测试步骤和预期结果等信息

约束限制:

数组元素数量范围为0~100

author

否

String

参数解释

创建人

约束限制

1-32个英文或者数字

取值范围

不涉及

默认取值

不涉及

name

是

String

参数解释

测试用例的名称

约束限制

长度限制128字符

取值范围

不涉及

默认取值

不涉及

rank

是

Integer

参数解释

用例等级

约束限制

不涉及

取值范围

  • 0:Priority 0

  • 1:Priority 1

  • 2:Priority 2

  • 3:Priority 3

  • 4:Priority 4

默认取值

不涉及

owner

否

String

参数解释

处理人

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

preparation

否

String

参数解释

前置条件

约束限制

长度限制3000字符

取值范围

不涉及

默认取值

不涉及

remark

否

String

参数解释

备注

约束限制

不涉及

取值范围

不超过20000字符

默认取值

不涉及

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

参数解释:

关联关系类型

约束限制:

不涉及

取值范围:

  • bug:缺陷

  • requirement:需求

默认取值:

不涉及

service_type

是

Integer

参数解释:

服务类型

约束限制:

不涉及

取值范围:

  • -1:全量用例

  • 0:手工测试

  • 1:接口自动化

  • 7:功能自动化

  • 8:WebUI自动化

  • 100:自定义自动化(工厂)

  • 11:性能自动化

默认取值:

不涉及

only_change_script

否

String

参数解释

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

约束限制

长度限制32字符

取值范围

不涉及

默认取值

不涉及

add_to_iterator

否

String

参数解释

需求添加到迭代标识

约束限制

长度限制5字符

取值范围

不涉及

默认取值

不涉及

need_update_relation

否

String

参数解释

是否修改关联关系

约束限制

长度限制5字符

取值范围

不涉及

默认取值

不涉及

creation_version_uri

否

String

参数解释

创建版本Uri,用于指定用例的创建版本。获取方式请参见获取版本URI接口

约束限制

11到34位英文或数字

取值范围

不涉及

默认取值

不涉及

number

否

String

参数解释

用例编号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

case_type

否

Integer

参数解释:

用例类型

约束限制:

不涉及

取值范围:

  • 0:手工测试

  • 1:接口自动化

  • 2:性能用例

默认取值:

不涉及

platform_type

否

Integer

参数解释

执行平台类型

约束限制

不涉及

取值范围

取值范围:-128-127

默认取值

不涉及

test_type

否

Integer

参数解释:

测试类型

取值范围:

  • 1:功能性测试

  • 2:兼容性测试

  • 4:性能测试

  • 15:易用性测试

  • 22:可靠性测试

  • 14:安全性测试

  • 21:可服务性测试

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:是自动化

默认取值:

不涉及

to_be_auto_exec

否

Integer

参数解释

被自动化执行

约束限制

不涉及

取值范围

  • 0:不被自动化

  • 1:被自动化

默认取值

不涉及

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

参数解释

是否已被自动化执行

约束限制

不涉及

取值范围

  • 0:未被自动化执行

  • 1:已被自动化执行

默认取值

不涉及

first_execute_time

否

String

参数解释

第一次执行时间,格式为yyyy-MM-dd HH:mm:ss,例如2024-01-01 12:00:00

约束限制

不涉及

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

参数解释

记录用例由非自动化变为自动化类型的时间,格式为yyyy-MM-dd HH:mm:ss,例如2024-01-01 12:00:00

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

compare_number

否

String

参数解释

配对用例编号

约束限制

长度限制100字符

取值范围

不涉及

默认取值

不涉及

scene_flag

否

String

参数解释

场景标识

约束限制

长度限制50字符

取值范围

不涉及

默认取值

不涉及

base_flag

否

String

参数解释

基准标识

约束限制

长度限制50字符

取值范围

不涉及

默认取值

不涉及

para_validator

否

String

参数解释

标识用例是否从yaml文件生成

约束限制

长度限制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

参数解释

最后执行时间,格式为yyyy-MM-dd HH:mm:ss

约束限制

不涉及

execute_duration

否

String

参数解释

执行时长,格式为HH:mm:ss(时:分:秒)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

is_keyword

否

Integer

参数解释

是否关键用例

约束限制

不涉及

取值范围

  • 0:非关键用例

  • 1:关键用例

默认取值

不涉及

release_dev

否

String

参数解释

测试版本号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

new_created

否

Integer

参数解释

是否用户新增用例

约束限制

不涉及

取值范围

  • 0:非用户新增

  • 1:用户新增

默认取值

不涉及

execute_parameter

否

String

参数解释

执行参数

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

project_uuid

是

String

参数解释

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

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

version_uri

否

String

参数解释

分支或者迭代uri。获取方式:从GET /v4/projects/{project_id}/iterator-infos的返回字段获取

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表3 TestCaseAttachmentInfo

参数

是否必选

参数类型

描述

override

否

Boolean

参数解释

附件是否要被覆盖

约束限制

不涉及

取值范围

  • true:附件将被覆盖

  • false:附件不被覆盖

默认取值

不涉及

doc_id

否

String

参数解释

文档id,获取方式请参见上传附件接口

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

file_name

是

String

参数解释

文件名

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

file_path

否

String

参数解释

文件路径

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

file_type

否

String

参数解释:

文件类型

约束限制:

根据文件后缀扩展名填入

取值范围:

不涉及

默认取值:

不涉及

file_size

否

String

参数解释

文件大小,单位是字节(Byte)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

override_id

否

String

参数解释

要覆盖的旧附件记录ID。获取方式请参见上传附件接口

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

related_type

否

String

参数解释:

相关类型

约束限制:

不涉及

取值范围:

  • 0:本地上传

  • 1:关联文档

默认取值:

不涉及

store_file_name

否

String

参数解释

保存文件名

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

system_type

否

String

参数解释:

系统类型

约束限制:

根据系统类型传入对应的值

取值范围:

  • docman:docman系统

  • testman:testman系统

默认取值:

不涉及

storage_system

否

String

参数解释

区分文件存储系统

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表4 TestCaseStepInfo

参数

是否必选

参数类型

描述

test_step

否

String

参数解释

测试步骤

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

expect_result

否

String

参数解释

预期结果

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

step_actual

否

String

参数解释

步骤的实际结果

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

step_result

否

String

参数解释

步骤结果

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

value

TestCaseVo object

参数解释:

请求返回的结果

取值范围:

不涉及

表6 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_id

String

参数解释

创建人ID

取值范围

不涉及

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_id

String

参数解释

工作项id

取值范围

不涉及

issue_tracker_id

String

参数解释

工作项类型id

取值范围

不涉及

issue_assign_status

String

参数解释

工作项分配状态

取值范围

不涉及

issue_name

String

参数解释

需求名称

取值范围

不涉及

issue_design_owner

String

参数解释

工作项设计责任人

取值范围

不涉及

issue_design_owner_d

String

参数解释

工作项设计责任人id

取值范围

不涉及

tracker_name

String

参数解释

工作项类型名称

取值范围

不涉及

defect_list

Array of NameAndId objects

参数解释

缺陷列表

取值范围

不涉及

result_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

参数解释

用例标签名称列表

取值范围

不涉及

status_name

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

取值范围

不涉及

表7 NameAndId

参数

参数类型

描述

id

String

参数解释:

对象编号

取值范围:

11-34位的字母及数字(字符串)

name

String

参数解释:

对象名称

取值范围:

不涉及

状态码:400

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:401

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:404

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:500

表11 响应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" : [ {
    "file_name" : "版本搬迁_sourcePaths.txt"
  } ]
}

响应示例

状态码:200

{
  "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

错误码

请参见错误码。

相关文档