外部系统创建测试用例 - 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

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