文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 自定义测试服务用例管理/ 创建自定义测试服务类型用例
更新时间：2024-11-19 GMT+08:00
查看PDF
分享

创建自定义测试服务类型用例

功能介绍

创建自定义测试服务类型用例

URI

POST /v1/projects/{project_id}/testcases

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表3 请求Body参数

参数

是否必选

参数类型

描述

extend_info

否

ExternalServiceCaseInfo object

测试用例其他扩展信息

name

是

String

页面上显示的用例名称，长度为[3-128]位字符

rank_id

否

String

测试用例等级，可选值为[0,1,2,3,4]，不填时默认为2

service_id

是

Integer

该值由注册接口返回，取值范围为10-9999

testcase_number

否

String

用例编号，不填该值时会自动生成，长度为[3-128]位字符
表4 ExternalServiceCaseInfo

参数

是否必选

参数类型

描述

assigned_id

否

String

处理者id信息，长度为0-32。

description

否

String

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

fix_version_id

否

String

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

issue_id

否

String

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

label_list

否

Array of strings

标签名称列表，数组长度小于等于30。单个名称长度不超过25。

module_id

否

String

模块号，长度为0-32。

preparation

否

String

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

steps

否

Array of ExternalServiceCaseStep objects

测试步骤，数组长度小于10

test_version_id

否

String

测试版本号，长度为1-64。
表5 ExternalServiceCaseStep

参数

是否必选

参数类型

描述

expect_result

否

String

测试用例预期结果信息，长度为[0-500]位字符

test_step

否

String

测试步骤描述信息，长度为[0-500]位字符

响应参数

状态码： 201

表6 响应Body参数

参数

参数类型

描述

assigned_user

AssignedUserInfo object

处理者信息

execute_count

Integer

测试用例执行次数

extend_info

ExtendInfo object

测试用例扩展信息

name

String

测试用例名称

project_id

String

软开云项目唯一标识

rank_id

String

测试用例等级

result_id

String

测试用例执行结果

service_id

Integer

注册测试类型服务接口返回的服务id

status_id

String

测试用例状态

testcase_id

String

用例uri,测试用例唯一标识,长度11-34位字符（字母和数字）。

testcase_number

String

测试用例编号
表7 ExtendInfo

参数

参数类型

描述

author

ExtendAuthorInfo object

创建者信息

defect_list

Array of AssignedUserInfo objects

缺陷信息

description

String

描述信息

domain

AssignedUserInfo object

租户信息

fixed_version

AssignedUserInfo object

迭代信息

issue

AssignedUserInfo object

需求信息

label_list

Array of AssignedUserInfo objects

标签信息

module

AssignedUserInfo object

模块信息

preparation

String

前置条件

steps

Array of ExternalServiceCaseStep objects

测试步骤，数组长度小于10

test_version_id

String

测试版本号

updator

ExtendAuthorInfo object

更新者信息
表8 AssignedUserInfo

参数

参数类型

描述

id

String

id信息

name

String

名称信息
表9 ExternalServiceCaseStep

参数

参数类型

描述

expect_result

String

测试用例预期结果信息，长度为[0-500]位字符

test_step

String

测试步骤描述信息，长度为[0-500]位字符
表10 ExtendAuthorInfo

参数

参数类型

描述

id

String

id信息

name

String

名称信息

time

String

时间信息

状态码： 400

表11 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码： 401

表12 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码： 404

表13 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码： 500

表14 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

请求示例

创建自定义测试服务类型用例

post https://{endpoint}/v1/projects/efdb403066474ab08836b9eeaaa23bca/testcases

{
  "extend_info" : {
    "assigned_id" : "1111",
    "description" : "这是一段用例描述信息",
    "fix_version_id" : "11111",
    "issue_id" : "11111",
    "label_list" : [ "标签名称" ],
    "module_id" : "模块号",
    "preparation" : "需要满足的前置条件",
    "steps" : [ {
      "expect_result" : "[\"\\u003cp\\u003e预期结果1\\u003c/p\\u003e\",\"\\u003cp\\u003e预期结果2\\u003c/p\\u003e\"]",
      "test_step" : "[\"\\u003cp\\u003e步骤描述1\\u003c/p\\u003e\",\"\\u003cp\\u003e步骤描述2\\u003c/p\\u003e\"]"
    } ],
    "test_version_id" : "11111"
  },
  "name" : "testcase",
  "rank_id" : "2",
  "service_id" : 13,
  "testcase_number" : "1234"
}

响应示例

状态码： 201

Created

{
  "assigned_user" : {
    "id" : "ID",
    "name" : "名称"
  },
  "execute_count" : 4,
  "extend_info" : {
    "author" : {
      "id" : "1111",
      "name" : "名称",
      "time" : "2000-01-01 00:00:00"
    },
    "defect_list" : [ {
      "id" : "ID",
      "name" : "名称"
    } ],
    "description" : "描述信息",
    "domain" : {
      "id" : "ID",
      "name" : "名称"
    },
    "fixed_version" : {
      "id" : "ID",
      "name" : "名称"
    },
    "issue" : {
      "id" : "ID",
      "name" : "名称"
    },
    "label_list" : [ {
      "id" : "ID",
      "name" : "名称"
    } ],
    "module" : {
      "id" : "ID",
      "name" : "名称"
    },
    "preparation" : "前置条件",
    "steps" : [ {
      "expect_result" : "[\"\\u003cp\\u003e预期结果1\\u003c/p\\u003e\",\"\\u003cp\\u003e预期结果2\\u003c/p\\u003e\"]",
      "test_step" : "[\"\\u003cp\\u003e步骤描述1\\u003c/p\\u003e\",\"\\u003cp\\u003e步骤描述2\\u003c/p\\u003e\"]"
    } ],
    "test_version_id" : "97b82412f1",
    "updator" : {
      "id" : "1111",
      "name" : "名称",
      "time" : "2000-01-01 00:00:00"
    }
  },
  "name" : "某个测试用例",
  "project_id" : "2394921",
  "rank_id" : "2",
  "result_id" : "0",
  "service_id" : 13,
  "status_id" : "1",
  "testcase_id" : "97b82412f1ca4628803b918c27ed09de",
  "testcase_number" : "1234"
}

状态码

状态码

描述

201

Created

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

相关文档