更新时间:2025-12-27 GMT+08:00
分享

外部系统创建测试用例 - CreateCase

功能介绍

此接口用于外部系统在项目下创建测试用例,同页面 测试 -> 测试用例 -> 新建用例

调用方法

请参见如何调用API

URI

POST /v4/testhub/projects/{project_id}/testcases

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

name

String

用例名称

service_id

Integer

服务类型

rank_id

String

用例等级ID

testcase_number

String

用例编号

version_uri

String

版本URI

extend_info

ExternalServiceBizCase object

用例扩展信息

表3 ExternalServiceBizCase

参数

是否必选

参数类型

描述

assigned_id

String

参数解释:

处理者id信息,长度0-32位

约束限制:

不涉及

取值范围:

0-32位字符

默认取值:

不涉及

defect_id_list

Array of strings

参数解释:

缺陷id信息,数组长度小于50个

约束限制:

不涉及

取值范围:

数组长度小于50

默认取值:

不涉及

description

String

参数解释:

测试用例描述信息,长度为[0-20000]位字符

约束限制:

不涉及

取值范围:

0-500位字符

默认取值:

不涉及

fix_version_id

String

参数解释:

迭代号,长度为[0-32]位字符

约束限制:

不涉及

取值范围:

0-32位字符

默认取值:

不涉及

issue_id

String

参数解释:

用例关联的需求id信息,长度为[0-32]位字符

约束限制:

不涉及

取值范围:

0-32位字符

默认取值:

不涉及

label_list

Array of strings

参数解释:

标签名称列表,数组长度小于25

约束限制:

不涉及

取值范围:

数组长度小于25

默认取值:

不涉及

module_id

String

参数解释:

模块号,长度为[0-32]位字符

约束限制:

不涉及

取值范围:

0-32位字符

默认取值:

不涉及

preparation

String

参数解释:

执行该测试用例时需要满足的前置条件,长度为[0-500]位字符

约束限制:

不涉及

取值范围:

0-500位字符

默认取值:

不涉及

status_id

String

参数解释:

测试用例状态信息,(0-新建,5-设计中,6-测试中,7-完成)

约束限制:

不涉及

取值范围:

0-新建,5-设计中,6-测试中,7-完成

默认取值:

不涉及

steps

Array of ExternalServiceCaseStep objects

参数解释:

测试步骤,数组长度小于等于100

约束限制:

不涉及

取值范围:

数组长度小于10

默认取值:

不涉及

test_version_id

String

测试版本号,长度为[1-64]位字符

表4 ExternalServiceCaseStep

参数

是否必选

参数类型

描述

expect_result

String

参数解释:

测试用例预期结果信息

约束限制:

不涉及

取值范围:

0-20000位字符

默认取值:

不涉及

test_step

String

参数解释:

测试步骤描述信息

约束限制:

不涉及

取值范围:

0-20000位字符

默认取值:

不涉及

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

testcase_id

String

用例id

project_id

String

项目ID

service_id

String

服务类型

name

String

名称

testcase_number

String

用例编号

rank_id

String

用例等级

status_id

String

用例状态

execute_count

Integer

用例结果数

result_id

Integer

用例结果

assigned_user

String

用例处理人信息

extend_info

Object

用例扩展信息

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:401

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:500

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

请求示例

post https://{endpoint}/v4/testhub/projects/a5eb0d410ea341a192f7c12483568985/testcases

{
  "name" : "用例1",
  "service_id" : 0,
  "rank_id" : "1",
  "testcase_number" : "123",
  "version_uri" : "v90100010gpop318",
  "extend_info" : { }
}

响应示例

状态码:200

OK

{
  "testcase_id" : "001rvc8k178",
  "project_id" : "0000dbab7df44231a72bfa25a1259c73",
  "service_id" : 3,
  "name" : "用例",
  "testcase_number" : "用例编号:-Copy-bbe028df",
  "rank_id" : 2,
  "status_id" : "4sfsd82e",
  "execute_count" : 1,
  "result_id" : "4sfsd82e",
  "assigned_user" : { },
  "extend_info" : { }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档