更新时间：2026-06-12 GMT+08:00
V5添加用例到任务 - V5AddTestcaseToTask
功能介绍
此接口用于V5版本添加用例到任务
调用方法
请参见如何调用API。
URI
POST /v5/{project_id}/tasks/add/testcase
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| task_uri | 否 | String | 任务唯一标识 |
| testcase_uris | 否 | Array of strings | 测试用例URI列表 |
| iteration_uri | 否 | String | 迭代URI |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | Integer | 起始记录数 大于 实际总条数时，值为0，分页请求才有此值 |
| value | String | 实际的数据类型：单个对象，集合 或 NULL |
| reason | String | 业务失败的提示内容 |
| page_size | Integer | 分页大小 |
| page_no | Integer | 分页编码 |
| has_more | Boolean | 是否有更多 |
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释 接口调用失败错误码 取值范围 不涉及 |
| error_msg | String | 参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码：500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释 接口调用失败错误码 取值范围 不涉及 |
| error_msg | String | 参数解释 接口调用失败错误信息 取值范围 不涉及 |
请求示例
V5添加用例到任务
POST https://{endpoint}/v5/{project_id}/tasks/add/testcase
{
"task_uri" : "task-001",
"testcase_uris" : [ "tc-001", "tc-002" ]
} 响应示例
状态码：200
OK
{
"value" : "添加成功",
"reason" : ""
} 状态码：400
Bad Request
{
"error_code" : "CLOUDTEST.00000001",
"error_msg" : "返回的错误信息"
} 状态码：500
Internal Server Error
{
"error_code" : "CLOUDTEST.00000001",
"error_msg" : "返回的错误信息"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 500 | Internal Server Error |
错误码
请参见错误码。
父主题： 测试用例管理
