更新时间：2026-10-22 GMT+08:00
导入测试用例 - ImportTestCaseList
功能介绍
此接口用于导入测试用例到指定版本
调用方法
请参见如何调用API。
URI
POST /v4/{project_id}/versions/{version_uri}/testcases/import
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目UUID，项目唯一标识。获取方式请参见获取项目ID 约束限制: 不涉及 取值范围: 长度等于32位，包含大小写字母、数字 默认取值: 不涉及 |
| version_uri | 是 | String | 参数解释 版本URI，分支或者迭代URI 取值范围 字符串 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| file | 否 | File | 导入文件 |
| service_type | 否 | Integer | 服务类型 |
| is_async | 否 | Boolean | 是否异步执行 |
| create_features | 否 | Boolean | 是否自动创建特性目录 |
| is_cover | 否 | Boolean | 是否覆盖式导入 |
| service_type_can_empty | 否 | Boolean | 执行方式是否可以为空 默认取值： true |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| value | String | 参数解释 resultObject 取值范围 不涉及 |
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码：500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
请求示例
导入测试用例
post https://{endpoint}/v4/{project_uuid}/versions/{version_uri}/testcases/import
{
"service_type" : 0,
"is_async" : false,
"create_features" : false,
"is_cover" : false
} 响应示例
状态码：200
{
"value" : "001rv8jtamo6",
"reason" : ""
} 状态码：400
{
"error_code" : "CLOUDTEST.00000001",
"error_msg" : "返回的错误信息"
} 状态码：500
{
"error_code" : "CLOUDTEST.00000001",
"error_msg" : "返回的错误信息"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 500 | Internal Server Error |
错误码
请参见错误码。
父主题： 导入管理
