文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 自定义测试服务用例管理/ 查询用例详情(APIG) - ShowProjectTestCaseDetail
更新时间:2025-12-27 GMT+08:00
分享

查询用例详情(APIG) - ShowProjectTestCaseDetail

功能介绍

此接口用于查询项目下指定用例uri的用例详情信息

调用方法

请参见如何调用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参数

参数

参数类型

描述

total

Integer

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

value

ProjectTestCaseVo object

用例详情

reason

String

业务失败的提示内容

page_size

Integer

页码

page_no

Integer

页数

has_more

Boolean

是否有更多

表4 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

扩展信息

表5 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

参数解释:

用例状态码

约束限制:

不涉及

取值范围:

  • -1,删除。

  • 0,新建。

  • 5,设计中。

  • 6,测试中。

  • 7,完成。

  • -2,未设置。

默认取值:

不涉及

module

NameAndIdVo object

模块信息

iteration

NameAndIdVo object

迭代信息

labels

Array of NameAndIdVo objects

标签信息

issue

NameAndIdVo object

需求信息

catalog

NameAndIdVo object

所属目录信息

表6 TestCaseStepVo

参数

参数类型

描述

test_step

String

测试步骤

expect_result

String

预期结果

step_actual

String

步骤的实际结果

step_result

String

步骤结果

表7 NameAndIdVo

参数

参数类型

描述

id

String

参数解释:

ID

取值范围:

不涉及

name

String

参数解释:

名称

取值范围:

不涉及

状态码:400

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:401

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:404

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:500

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

请求示例

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

响应示例

状态码:200

OK

{
  "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

错误码

请参见错误码

相关文档