外部系统获取测试用例详情 - ShowExternalTestCaseWithUri

功能介绍

此接口用于获取测试用例详情信息,同页面测试 -> 测试用例 -> 列表单击用例查看详情。

调用方法

请参见如何调用API。

URI

GET /v4/testhub/projects/{project_id}/testcases/{case_uri}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID
case_uri	是	String	用例uri

请求参数

无

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
status	String	参数解释: 调用此接口的响应状态。取值范围: success，表示接口调用成功。 error，表示接口调用失败。
error	ApiError object	错误信息
request_id	String	由接口调用方传入，建议使用UUID保证请求的唯一性。
server_address	String	本次请求的受理的服务地址
result	ExternalQueryCaseVo object	返回结果

表3 ApiError
参数	参数类型	描述
code	String	业务失败的错误编码
reason	String	业务失败的提示内容

表4 ExternalQueryCaseVo
参数	参数类型	描述
testcase_id	String	用例id
project_id	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID
service_id	Integer	服务类型
name	String	名称
testcase_number	String	用例编号
rank_id	Integer	用例等级
status_id	String	用例状态
execute_count	Integer	用例结果数
result_id	String	用例结果
assigned_user	NameAndIdVo object	服务类型信息
extend_info	ExtendInfoVo object	用例扩展信息

表5 ExtendInfoVo
参数	参数类型	描述
author	UserBaseVo object	用例更新信息
updator	UserBaseVo object	用例更新信息
domain	NameAndIdVo object	服务类型信息
preparation	String	前置条件
steps	Array of TestCaseStepVo objects	用例测试步骤和预期结果
module	NamePathAndPathVo object	用例模块信息
issue	NameAndIdVo object	服务类型信息
description	String	备注
label_list	Array of NameAndIdVo objects	用例标签信息
defect_list	Array of NameAndIdVo objects	用例tracker信息
fixed_version	NameAndIdVo object	服务类型信息
test_version_id	String	版本号

表6 UserBaseVo
参数	参数类型	描述
id	String	用户id
name	String	用户名
time	String	更新或者创建时间

表7 TestCaseStepVo
参数	参数类型	描述
test_step	String	测试步骤
expect_result	String	预期结果

表8 NamePathAndPathVo
参数	参数类型	描述
id	String	ID
name	String	名称
path	String	路径id
path_name	String	模块路径名称

表9 NameAndIdVo
参数	参数类型	描述
id	String	ID
name	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/testhub/projects/1b7179edc79a431f9711434124ac9f28/testcase?testcase_number=101

响应示例

状态码：200

{
  "rank_id" : 2,
  "status_id" : "0",
  "project_id" : "1b7179edc79a431f9711434124ac9f28",
  "execute_count" : 0,
  "result_id" : "",
  "service_id" : 10006,
  "name" : "自定义01",
  "assigned_user" : {
    "name" : "",
    "id" : ""
  },
  "testcase_id" : "v90200010s48bmvs",
  "extend_info" : {
    "test_version_id" : "",
    "label_list" : [ ],
    "fixed_version" : {
      "name" : "",
      "id" : ""
    },
    "issue" : {
      "name" : "",
      "id" : ""
    },
    "author" : {
      "name" : "wangluodan1",
      "id" : "a17801c5d15f46e28112eec8a880683d",
      "time" : "2025-10-18 10:56:29"
    },
    "domain" : {
      "name" : "",
      "id" : ""
    },
    "module" : {
      "name" : "",
      "id" : ""
    },
    "updator" : {
      "name" : "www",
      "id" : "a17801c5d15f46e2811asdqwe880683d",
      "time" : "2025-10-18 14:23:01"
    },
    "description" : "12312",
    "steps" : [ {
      "test_step" : "",
      "expect_result" : ""
    } ],
    "defect_list" : [ ],
    "preparation" : ""
  },
  "testcase_number" : "115"
}