# 查询用例详情（APIG） - ShowProjectTestCaseDetail #### 功能介绍 此接口用于查询项目下指定用例uri的用例详情信息 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI GET /v4/projects/{project_id}/testcases/{testcase_uri} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html)。 | | testcase_uri | 是 | String | 用例id | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | plan_id | 否 | String | **参数解释**: 测试计划id或测试版本ID **约束限制**: 不涉及 **取值范围**: 长度11-34位字符（字母和数字） **默认取值**: 不涉及 **获取方法**： 对应测试计划管理页面创建的测试计划对象以及版本管理中创建的版本对象，测试用例列表页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testcase?branch_id={branch_id}\&testplan_id={testplan_id}中变量branch_id/testplan_id的值 | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 | | value | [ProjectTestCaseVo] object | 用例详情 | | reason | String | 业务失败的提示内容 | | page_size | Integer | 页码 | | page_no | Integer | 页数 | | has_more | Boolean | 是否有更多 | 表4ProjectTestCaseVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 用例id | | name | String | 用例名称 | | result | String | 用例结果 | | project_id | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html)。 | | service_id | Integer | 服务id | | testcase_number | String | 用例编号 | | rank_id | Integer | 用例级别 | | extend_info | [ProjectTestCaseExtendVo] object | 扩展信息 | 表5ProjectTestCaseExtendVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 所属目录信息 | 表6TestCaseStepVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | test_step | String | 测试步骤 | | expect_result | String | 预期结果 | | step_actual | String | 步骤的实际结果 | | step_result | String | 步骤结果 | 表7NameAndIdVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。