更新时间:2025-07-25 GMT+08:00
分享

查询用例详情(APIG)

功能介绍

查询用例详情(APIG)

调用方法

请参见如何调用API

URI

GET /v4/projects/{project_id}/testcases/{testcase_uri}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

testcase_uri

String

用例id

表2 Query参数

参数

是否必选

参数类型

描述

plan_id

String

计划uri

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

status

String

success|error

result

ResultValueProjectTestCaseVo object

用例详情

error

ApiError object

错误信息

request_id

String

由接口调用方传入,建议使用UUID保证请求的唯一性。

server_address

String

本次请求的受理的服务地址

表4 ResultValueProjectTestCaseVo

参数

参数类型

描述

total

Integer

起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值

value

ProjectTestCaseVo object

用例详情

reason

String

业务失败的提示内容

page_size

Integer

页码

page_no

Integer

页数

has_more

Boolean

是否有更多

表5 ProjectTestCaseVo

参数

参数类型

描述

id

String

用例id

name

String

用例名称

result

String

用例结果

project_id

String

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

service_id

Integer

服务id

testcase_number

String

用例编号

rank_id

Integer

用例级别

extend_info

ProjectTestCaseExtendVo object

扩展信息

表6 ProjectTestCaseExtendVo

参数

参数类型

描述

owner_id

String

处理人id

owner_name

String

处理人名称

description

String

用例描述

preparation

String

预置条件

test_version

String

迭代id

script_path

String

测试脚本链接

steps

Array of TestCaseStepVo objects

测试步骤

script_url

String

测试脚本链接

status

String

用例状态码

module

NameAndIdVo object

用例状态码

iteration

NameAndIdVo object

迭代信息

labels

Array of NameAndIdVo objects

标签信息

issue

NameAndIdVo object

需求信息

catalog

NameAndIdVo object

所属目录信息

表7 TestCaseStepVo

参数

参数类型

描述

test_step

String

测试步骤

expect_result

String

预期结果

step_actual

String

步骤的实际结果

step_result

String

步骤结果

表8 NameAndIdVo

参数

参数类型

描述

id

String

参数解释:

ID

取值范围:

不涉及

name

String

参数解释:

名称

取值范围:

不涉及

表9 ApiError

参数

参数类型

描述

code

String

参数解释

错误编码

取值范围

不涉及

reason

String

参数解释

业务失败的提示内容

取值范围

不涉及

状态码:400

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:401

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:404

表12 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:500

表13 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

请求示例

get https://{endpoint}/v4/projects/a5eb0d410ea341a192f7c12483568985/testcases/v80b00010i5dji80

响应示例

状态码:200

OK

{
  "status" : "success",
  "result" : {
    "total" : 1,
    "value" : {
      "id" : "v9050000tl6s4sgg",
      "name" : "用例名称",
      "result" : "0",
      "project_id" : "4ec2e9894a76491f96970de72547353b",
      "service_id" : 11,
      "testcase_number" : "testcase_001",
      "rank_id" : 1,
      "extend_info" : { }
    },
    "page_size" : 10,
    "page_no" : 0,
    "has_more" : true
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档