查询标签 - ShowTags

功能介绍

此接口用于查询标签，同页面测试 -> 测试用例 -> 右侧展示用例列表，点击用例，进入用例详情页 -> 详情页右侧基本信息会展示用例标签

调用方法

请参见如何调用API。

URI

GET /v4/projects/{project_id}/tags

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 约束限制: 字符串类型，长度32位字符取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字默认取值: 不涉及

表2 Query参数
参数	是否必选	参数类型	描述
resource_type	是	String	参数解释所属资源类型约束限制不涉及取值范围 TestCase，用例。 Task，测试套。默认取值不涉及

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：必传。取值范围：字符串长度不少于1，不超过10万。默认取值：不涉及。

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
value	Array of LabelVo objects	请求返回的数据

表5 LabelVo
参数	参数类型	描述
uri	String	参数解释 uri主键取值范围不涉及
region	String	参数解释逻辑region 取值范围不涉及
label_name	String	参数解释标签名称取值范围不涉及
service_type	String	参数解释: 服务类型取值范围: -1，全量用例。 0，手工测试。 1，接口自动化。 7，功能自动化。 8，WebUI自动化。 100，自定义自动化(工厂)。 11，性能自动化。
resource_type	String	参数解释所属资源类型取值范围 TestCase，用例。 Task，测试套。
project_uuid	String	参数解释项目UUID 取值范围项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID

状态码：400

表6 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：401

表7 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：404

表8 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：500

表9 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

请求示例

查询标签

get https://{endpoint}/v4/projects/300c6295a54c4c698608c878f47ddd59/tags?resource_type=TestCase

响应示例

状态码：200

{
  "value" : [ {
    "uri" : "v91j0000vpmr57j9",
    "region" : "cn-north-7",
    "label_name" : "对对对对对对多",
    "resource_type" : "TestCase"
  }, {
    "uri" : "v91j0vpmr57j939o",
    "region" : "cn-north-7",
    "label_name" : "咕咕咕咕咕咕过过过过",
    "resource_type" : "TestCase"
  } ]
}