# 批量新建接口用例,APITest调用或者新建性能测试用例 - BatchCreateApiTestCase #### 功能介绍 此接口除了传标注的必填参数以外，也要传项目中其它自定义必填字段。其它自定义必填字段请前往项目设置查看（设置-测试设置-测试用例设置） #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/{project_id}/batch/add/automatic/testcases 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html)。 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | service_type | 是 | String | 类型 **约束限制**: 不涉及 **取值范围**: - -1，全量用例。 - 0，手工测试。 - 1，接口自动化。 - 7，功能自动化。 - 8，WebUI自动化。 - 100，自定义自动化(工厂)。 - 11，性能自动化。 **默认取值**: 不涉及 | | 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 | 表3TestCaseStepInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | test_step | 否 | String | 测试步骤 | | expect_result | 否 | String | 预期结果 | | step_actual | 否 | String | 步骤的实际结果 | | step_result | 否 | String | 步骤结果 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 | | value | [BatchCreateUpdateApiTestCaseVo] object | 用例列表 | | reason | String | 业务失败的提示内容 | | page_size | Integer | 每页数据条数 | | page_no | Integer | 页码 | | has_more | Boolean | 是否还有更多 | 表5BatchCreateUpdateApiTestCaseVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | 资源URI | | type | String | **参数解释**: 资源类型 **取值范围**: - TestCase，用例。 - TestItem，目录。 - IteratorTestCase，迭代用例。 | | 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 | 创建失败的用例列表 | 表6TestCaseVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | 资源URI | | type | String | **参数解释**: 资源类型 **取值范围**: - TestCase，用例。 - TestItem，目录。 - 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 | 处理人 | | 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 | **参数解释**: 用例类型 **取值范围**: - 0，手工测试。 - 1，接口自动化。 - 2，性能用例。 | | platform_type | Integer | 执行平台类型 | | service_type | Integer | **参数解释**: 服务类型 **取值范围**: - -1，全量用例。 - 0，手工测试。 - 1，接口自动化。 - 7，功能自动化。 - 8，WebUI自动化。 - 100，自定义自动化(工厂)。 - 11，性能自动化。 | | test_type | Integer | **参数解释**: 测试类型 **取值范围**: - 1，功能性测试。 - 2，兼容性测试。 - 4，性能测试。 - 15，易用性测试。 - 22，可靠性测试。 - 14，安全性测试。 - 21，可服务性测试。 | | 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 | | 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_uuid | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | creation_version_name | String | 创建版本名称 | | feature_path | String | 特性路径 | | issue_id | String | 工作项id | | issue_tracker_id | String | 工作项类型id | | issue_assign_status | String | **参数解释**: 工作项分配状态。 **取值范围**: - 0，设计待分配。 - 1，设计中。 - 2，设计完成（待分配）。 - 3，测试中。 - 4，已测试。 | | 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 | 结果数量 | | testcase_uri | String | 实体用例Uri，IteratorTestCase字段 | 表7BaseNameAndId | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 名称 | | id | String | id | 表8TestCaseInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | service_type | String | 类型 **取值范围**: - -1，全量用例。 - 0，手工测试。 - 1，接口自动化。 - 7，功能自动化。 - 8，WebUI自动化。 - 100，自定义自动化(工厂)。 - 11，性能自动化。 | | 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 | 表9TestCaseStepInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | test_step | String | 测试步骤 | | expect_result | String | 预期结果 | | step_actual | String | 步骤的实际结果 | | step_result | String | 步骤结果 | **状态码：400** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 | **状态码：401** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 | **状态码：404** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 | **状态码：500** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 | #### 请求示例 ``` post https://{endpoint}/v4/a5eb0d410ea341a192f7c12483568985}/batch/add/automatic/testcases { "name" : "hahaha19c", "service_type" : "1", "project_uuid" : "1b7179edc79a431f9711434124ac9f28" } ``` #### 响应示例 **状态码：200** OK ``` { "value" : { "uri" : "001s16gt6q5", "type" : "TestVersion", "author" : "efdb403066474ab08836b9eeaaa23bca", "name" : "名称", "rank" : 1, "last_modifier" : "efdb403066474ab08836b9eeaaa23bca", "last_modified" : "2026-07-29T02:32:54.492Z", "last_modified_timestamp" : 1660617231016, "last_change_time" : "2026-07-29T02:32:54.492Z", "version_uri" : "001s16gt68e", "origin_uri" : "001rv5i9u14", "parent_uri" : "001s16gt68e", "parent_path" : "/b6c4288728234a2e804b6df9465d7b5b/001s16gt68e", "creation_version_uri" : "001s16gt68e", "creation_date" : "2026-07-29T02:32:54.492Z", "creation_date_timestamp" : 1660617231016, "author_name" : "tester", "comment" : "备注", "number" : "编号", "confidentiality_code" : "string" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。