批量新建接口用例,APITest调用或者新建性能测试用例 - BatchCreateApiTestCase
功能介绍
此接口除了传标注的必填参数以外,也要传项目中其它自定义必填字段。其它自定义必填字段请前往项目设置查看(设置-测试设置-测试用例设置)
调用方法
请参见如何调用API。
URI
POST /v4/{project_id}/batch/add/automatic/testcases
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
service_type | 是 | String | 类型 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
uri | 否 | String | 用例URI |
steps | 否 | Array of TestCaseStepInfo objects | 测试步骤 |
name | 是 | String | 名称 |
preparation | 否 | String | 前置条件 |
remark | 否 | String | 备注 |
number | 否 | String | 用例编号 |
svn_script_path | 否 | String | 脚本路径 |
feature_uri | 否 | String | 目录Uri |
label_names | 否 | Array of strings | 用例操作时,标签名列表 |
release_dev | 否 | String | 测试版本号 |
version_uri | 否 | String | 版本URI |
min_similarity | 否 | String | 用例相似度下限(两位有效小数) |
project_uuid | 是 | String | 项目id |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
total | Integer | 起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值 |
value | 用例列表 | |
reason | String | 业务失败的提示内容 |
page_size | Integer | 每页数据条数 |
page_no | Integer | 页码 |
has_more | Boolean | 是否还有更多 |
参数 | 参数类型 | 描述 |
|---|---|---|
uri | String | 资源URI |
type | String | 参数解释: 资源类型 取值范围:
|
author | String | 创建人 |
name | String | 名称 |
rank | Integer | 级别 |
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 | 编号 |
success_list | Array of TestCaseVo objects | 创建成功的用例列表 |
failed_list | Array of TestCaseInfo objects | 创建失败的用例列表 |
参数 | 参数类型 | 描述 |
|---|---|---|
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 | 处理人 |
version_uri | String | 版本URI |
origin_uri | String | 源资源URI |
parent_uri | String | 父资源URI |
parent_path | String | 父资源路径 |
creation_version_uri | String | 创建版本URI |
last_modifier | String | 最后修改人 |
last_modified | String | 最后修改时间 |
last_change_time | String | 最后变更时间 |
creation_date | String | 创建时间 |
author_id | String | 创建人ID |
comment | String | 备注 |
number | String | 开发分支名称 |
case_type | Integer | 参数解释: 用例类型 取值范围:
|
platform_type | Integer | 执行平台类型 |
service_type | Integer | 参数解释: 服务类型 取值范围:
|
test_type | Integer | 参数解释: 测试类型 取值范围:
|
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 | 参数解释: 自动化类型 取值范围:
|
to_be_auto_exec | Integer | 被自动化执行 |
last_result | String | 最后一次结果 |
last_result_uri | String | 最后一次结果Uri |
feature_uri | String | 目录Uri |
interface_name | String | 测试接口名 |
snp_no | String | 网络问题ID |
dr_relation_id | 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 | 是否是契约用例 |
time_cost | Double | 总共耗时 |
custom_field_1 | String | 自定义字段1 |
custom_field_2 | String | 自定义字段2 |
custom_field_3 | String | 自定义字段3 |
custom_field_4 | String | 自定义字段4 |
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 |
module_id | String | 模块ID |
execute_latest_time | String | 最后执行时间 |
execute_duration | String | 执行时长 |
execute_times | Integer | 执行次数 |
is_keyword | Integer | 是否关键用例 |
release_dev | String | 测试版本号 |
new_created | String | 是否用户新增用例 |
project_id | String | 项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID |
creation_version_name | String | 创建版本名称 |
feature_path | 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 BaseNameAndId objects | 缺陷列表 |
result_name | String | 结果名称 |
status_name | String | 状态名称 |
module_name | String | 模块名称 |
module_name_path | String | 模块路径名称 |
module_id_path | String | 模块路径id |
version_name | String | 版本名称 |
resultCount | Integer | 结果数量 |
参数 | 参数类型 | 描述 |
|---|---|---|
service_type | String | 类型 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
uri | String | 用例URI |
steps | Array of TestCaseStepInfo objects | 测试步骤 |
name | String | 名称 |
preparation | String | 前置条件 |
remark | String | 备注 |
number | String | 用例编号 |
svn_script_path | String | 脚本路径 |
feature_uri | String | 目录Uri |
label_names | Array of strings | 用例操作时,标签名列表 |
release_dev | String | 测试版本号 |
version_uri | String | 版本URI |
min_similarity | String | 用例相似度下限(两位有效小数) |
project_uuid | String | 项目id |
参数 | 参数类型 | 描述 |
|---|---|---|
test_step | String | 测试步骤 |
expect_result | String | 预期结果 |
step_actual | String | 步骤的实际结果 |
step_result | String | 步骤结果 |
状态码:400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg | String | 参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码:401
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg | String | 参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码:404
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg | String | 参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码:500
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg | String | 参数解释 接口调用失败错误信息 取值范围 不涉及 |
请求示例
post https://{endpoint}/v4/a5eb0d410ea341a192f7c12483568985}/batch/add/automatic/testcases
{
"name" : "hahaha19c",
"service_type" : "1",
"project_uuid" : "1b7179edc79a431f9711434124ac9f28",
"custom_field_23" : "222"
} 响应示例
状态码:200
OK
{
"value" : {
"success_list" : [ {
"uri" : "v90200010scjm23o",
"type" : "TestCase",
"author" : "da48b09775884920a3745ccbd4a66f1e",
"name" : "hahaha139c",
"stage" : "1",
"designer" : "da48b09775884920a3745ccbd4a66f1e",
"region" : "roma-guian-2",
"last_modifier" : "da48b09775884920a3745ccbd4a66f1e",
"last_modified" : "2025-10-21 16:48:18",
"last_change_time" : "2025-10-21 16:48:18",
"version_uri" : "v90200010s1h6476",
"parent_uri" : "v90200010s1h6476",
"parent_path" : "/1b7179edc79a431f9711434124ac9f28/v90200010s1h6476/",
"creation_date" : "2025-10-21 16:48:18",
"number" : "TC1326",
"case_type" : 0,
"platform_type" : 0,
"service_type" : 1,
"test_type" : 0,
"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" : "1b7179edc79a431f9711434124ac9f28",
"testcase_uri" : "v90200010scjm23o",
"custom_field_23" : "222"
} ],
"failed_list" : [ ]
}
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
400 | Bad Request |
401 | Unauthorized |
404 | Not Found |
500 | Internal Server Error |
错误码
请参见错误码。

