更新时间:2024-08-30 GMT+08:00
分享

查询关联用例

功能介绍

查询关联用例

调用方法

请参见如何调用API

URI

GET /v4/projects/{project_id}/issues/{issue_id}/associate-test-cases

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:项目的32位uuid,项目唯一标识,可以通过ListProjectsV4接口查询项目列表

约束限制:正则表达式, ^[A-Za-z0-9]{32}$

取值范围:字符串,最小长度:32,最大长度:32

默认取值:不涉及

issue_id

Integer

参数解释:工作项id,可通过ListIssuesV4接口高级查询工作项

约束限制:正则表达式,[0-9]{1,10}$

取值范围:最小长度:1,最大长度:10

默认取值:不涉及

表2 Query参数

参数

是否必选

参数类型

描述

limit

Integer

参数解释:每页数量

约束限制:不涉及

取值范围:最小值:1 最大值:100

默认取值:100

offset

Integer

参数解释:偏移量 从0开始

约束限制:正则表达式,^0|[1-9]\d{0,10}$

取值范围:最小值:0

默认取值:0

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:不涉及

取值范围:最小长度:10,最大长度:32768

默认取值:不涉及

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

test_cases

Array of AssociatedTestCase objects

关联的测试用例列表

total

Integer

关联的测试用例总数

表5 AssociatedTestCase

参数

参数类型

描述

case_id

String

用例ID

case_num

String

用例编号

case_name

String

用例名称

case_level

String

用例等级

status

StatusVo object

状态

creator

SimpleUser object

创新者信息

owner

SimpleUser object

用例归属人信息

project

SimpleProject object

项目信息

is_base_line

Integer

是否基线

type

String

用例类型

created_time

Long

创建时间

表6 StatusVo

参数

参数类型

描述

id

String

状态id

name

String

状态id对应的值

表7 SimpleUser

参数

参数类型

描述

user_num_id

Integer

用户数字id

user_id

String

用户32位uuid,用户唯一标识

user_name

String

用户名

nick_name

String

用户昵称

表8 SimpleProject

参数

参数类型

描述

project_name

String

项目名称

project_id

String

项目32位uuid,项目唯一标识

状态码: 400

表9 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

状态码: 401

表10 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

请求示例

GET https://{endpoint}/v4/projects/{project_id}/issues/{issue_id}/associate-test-cases

GET https://{endpoint}/v4/projects/a360371833bf4c558f796fd707b44daf/issues/1234/associate-test-cases

响应示例

状态码: 200

ok

{
  "test_cases" : [ {
    "case_id" : "36cfaab019dc49cdb53b07aefe553f5a",
    "case_num" : "1",
    "case_name" : "demo",
    "case_level" : "2",
    "status" : {
      "id" : "1",
      "name" : "未开始"
    },
    "creator" : {
      "user_num_id" : 4091,
      "user_id" : "a360371833bf4c558f796fd707b44daf",
      "user_name" : "demo_user_name_xiongzhitest001",
      "nick_name" : "bear1"
    },
    "owner" : {
      "user_num_id" : 4091,
      "user_id" : "a360371833bf4c558f796fd707b44daf",
      "user_name" : "demo_user_name_xiongzhitest001",
      "nick_name" : "bear1"
    },
    "project" : {
      "project_name" : "demo",
      "project_id" : "58d9050550c847c89885c1797a718b0c"
    },
    "is_base_line" : 0,
    "type" : "1",
    "created_time" : 1233445566000
  } ],
  "total" : 0
}

状态码

状态码

描述

200

ok

400

Bad Request

401

Unauthorized

错误码

请参见错误码

相关文档