文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 自定义测试服务用例管理/ 外部系统创建测试用例

更新时间：2025-07-24 GMT+08:00

在线调试

CLI示例

查看PDF

外部系统创建测试用例

功能介绍

外部系统创建测试用例

调用方法

请参见如何调用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-500]位字符约束限制: 不涉及取值范围: 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	参数解释: 测试步骤，数组长度小于10 约束限制: 不涉及取值范围: 数组长度小于10 默认取值: 不涉及
test_version_id	否	String	测试版本号，长度为[1-64]位字符

表4 ExternalServiceCaseStep
参数	是否必选	参数类型	描述
expect_result	否	String	参数解释: 测试用例预期结果信息约束限制: 不涉及取值范围: 0-500位字符默认取值: 不涉及
test_step	否	String	参数解释: 测试步骤描述信息约束限制: 不涉及取值范围: 0-500位字符默认取值: 不涉及

响应参数

状态码：200

表5 响应Body参数
参数	参数类型	描述
status	String	success\|error
error	ApiError object	错误信息
request_id	String	由接口调用方传入，建议使用UUID保证请求的唯一性。
server_address	String	本次请求的受理的服务地址
result	ExternalQueryCaseVo object	请求结果

表6 ApiError
参数	参数类型	描述
code	String	参数解释错误编码取值范围不涉及
reason	String	参数解释业务失败的提示内容取值范围不涉及

表7 ExternalQueryCaseVo
参数	参数类型	描述
testcase_id	String	用例id
project_id	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID。
service_id	Integer	服务类型
name	String	名称
testcase_number	String	用例编号
rank_id	Integer	用例等级
status_id	String	用例状态
execute_count	Integer	用例结果数
result_id	String	用例结果
assigned_user	NameAndIdVo object	用例处理人信息
extend_info	ExtendInfoVo object	用例扩展信息

表8 ExtendInfoVo
参数	参数类型	描述
author	UserBaseVo object	作者
updator	UserBaseVo object	更新人
domain	NameAndIdVo object	domin
preparation	String	前置条件
steps	Array of TestCaseStepVo objects	用例测试步骤和预期结果
module	NamePathAndPathVo object	用例模块信息
issue	NameAndIdVo object	用例关联需求信息
description	String	备注
label_list	Array of NameAndIdVo objects	用例标签信息
defect_list	Array of NameAndIdVo objects	用例tracker信息
fixed_version	NameAndIdVo object	用例版本信息
test_version_id	String	版本号

表9 UserBaseVo
参数	参数类型	描述
id	String	用户id
name	String	用户名
time	String	更新或者创建时间

**表10** TestCaseStepVo
参数	参数类型	描述
test_step	String	测试步骤
expect_result	String	预期结果
step_actual	String	步骤的实际结果
step_result	String	步骤结果

**表11** NamePathAndPathVo
参数	参数类型	描述
id	String	ID
name	String	名称
path	String	路径id
path_name	String	模块路径名称

**表12** NameAndIdVo
参数	参数类型	描述
id	String	参数解释: ID 取值范围: 不涉及
name	String	参数解释: 名称取值范围: 不涉及

状态码：400

**表13** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围不涉及
error_msg	String	参数解释接口调用失败错误信息取值范围不涉及

状态码：401

**表14** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围不涉及
error_msg	String	参数解释接口调用失败错误信息取值范围不涉及

状态码：404

**表15** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围不涉及
error_msg	String	参数解释接口调用失败错误信息取值范围不涉及

状态码：500

**表16** 响应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

{
  "status" : "success",
  "result" : {
    "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

错误码

请参见错误码。

父主题： 自定义测试服务用例管理

上一篇：查询用例信息列表

下一篇：外部系统查询用例列表

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

外部系统创建测试用例

功能介绍

调用方法

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？