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

查询用例列表

功能介绍

查询用例列表

URI

POST /v1/{project_id}/testcases/batch-query

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

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

参数

是否必选

参数类型

描述

offset

是

Integer

起始偏移量，表示从此偏移量开始查询，offset大于等于0，小于等于100000

limit

是

Integer

每页显示的条目数量，最大支持200条

execution_type_id

否

Integer

用例测试执行方式ID

version_id

否

String

分支/测试计划ID，长度11-34位字符（字母和数字）。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

values

Array of ExternalTestCaseVo objects

用例详情列表

total

Integer

用例总数
表5 ExternalTestCaseVo

参数

参数类型

描述

name

String

用例名称

owner

NameAndIdVo object

处理者信息

status

NameAndIdVo object

状态信息

result

NameAndIdVo object

结果信息

module

NameAndIdVo object

模块信息

iteration

NameAndIdVo object

迭代信息

id

String

用例ID

number

String

用例编号

description

String

用例描述

rank_id

String

用例等级

project_id

String

项目ID

execution_type

NameAndIdVo object

用例测试执行类型

test_type

IntegerIdAndNameVo object

测试类型信息

create_info

CreateInfoVo object

创建信息

execute_info

ExecuteInfoVo object

执行信息

associate_issue_info

AssociateIssueInfoVo object

关联需求信息

associate_defect_info

AssociateDefectInfoVo object

关联缺陷信息
表6 NameAndIdVo

参数

参数类型

描述

id

String

ID

name

String

名称
表7 IntegerIdAndNameVo

参数

参数类型

描述

id

Integer

数据库存储数字

name

String

页面显示值
表8 CreateInfoVo

参数

参数类型

描述

time

String

创建时间

timestamp

Long

创建时间时间戳

user_id

String

用户ID

user_name

String

用户名称
表9 ExecuteInfoVo

参数

参数类型

描述

time

String

执行开始时间

timestamp

Long

执行开始时间时间戳

duration

String

执行时长

user_id

String

用户ID

user_name

String

用户名称

execute_times

Integer

执行次数
表10 AssociateIssueInfoVo

参数

参数类型

描述

associate

Boolean

是否已关联

issue_id

String

需求ID

tracker_id

String

需求类型

board_id

String

工作项层级ID

tracker_name

String

需求类型名称
表11 AssociateDefectInfoVo

参数

参数类型

描述

associate

Boolean

是否已关联

associate_count

Integer

关联缺陷数

状态码： 400

表12 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码： 401

表13 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码： 404

表14 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码： 500

表15 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

请求示例

查询用例列表

post https://{endpoint}/v1/efdb403066474ab08836b9eeaaa23bca/testcases/batch-query

{
  "offset" : 1,
  "limit" : 10,
  "execution_type_id" : 0,
  "version_id" : "005t8asecn21da"
}

响应示例

状态码： 200

OK

{
  "values" : [ {
    "name" : "测试用例",
    "owner" : {
      "id" : "id",
      "name" : "name"
    },
    "status" : {
      "id" : "id",
      "name" : "name"
    },
    "result" : {
      "id" : "id",
      "name" : "name"
    },
    "module" : {
      "id" : "id",
      "name" : "name"
    },
    "iteration" : {
      "id" : "id",
      "name" : "name"
    },
    "id" : "001rv8lk4he",
    "number" : "10010",
    "description" : "用例描述",
    "rank_id" : "2",
    "project_id" : "7672757",
    "execution_type" : {
      "id" : "id",
      "name" : "name"
    },
    "test_type" : {
      "id" : 1,
      "name" : "显示值"
    },
    "create_info" : {
      "time" : "2021-11-06 00:00:01",
      "timestamp" : 1660617231016,
      "user_id" : "efdb403066474ab08836b9eeaaa23bca",
      "user_name" : "测试Tester"
    },
    "execute_info" : {
      "time" : "2021-11-06 12:00:00",
      "timestamp" : 1660617231016,
      "duration" : "00:00:10",
      "user_id" : "efdb403066474ab08836b9eeaaa23bca",
      "user_name" : "测试Tester",
      "execute_times" : 1
    },
    "associate_issue_info" : {
      "associate" : true,
      "issue_id" : "4654022505049243648",
      "tracker_id" : "1",
      "board_id" : "443ef10e6c954b00a24ed6ce6864854a",
      "tracker_name" : "IR"
    },
    "associate_defect_info" : {
      "associate" : true,
      "associate_count" : 1
    }
  } ],
  "total" : 1
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

相关文档