Local API V2 – 标签接口

查询标签列表

接口地址

GET /openapi/v2/tags

用于查询标签列表。

查询参数

名称	类型	必填	说明
request	string	是	标签列表查询参数。

响应参数

data.list 为标签列表：

名称	类型	说明
id	string	标签 ID。
name	string	标签名称。
style	string	标签颜色：gray、red、orange、yellow、green、teal、blue、purple、pink。

创建标签

接口地址

POST /openapi/v2/tags

用于创建标签。

请求参数

名称	类型	必填	说明
name	string	否	标签名称。
style	string	否	标签颜色：gray、red、orange、yellow、green、teal、blue、purple、pink。

请求示例

 {
    "name": "automation",
    "style": "blue"
  }

给环境添加标签

接口地址

POST /openapi/v2/tags/{tagId}/profiles

用于给一个或多个环境添加指定标签。

路径参数

名称	类型	必填	说明
tagId	string	是	标签 ID。

请求参数

名称	类型	必填	说明
profile_ids	string[]	否	环境 ID 列表。

请求示例

 {
    "profile_ids": ["1876881021063852034"]
  }

从环境移除标签

接口地址

DELETE /openapi/v2/tags/{tagId}/profiles

用于从一个或多个环境中移除指定标签。

路径参数

名称	类型	必填	说明
tagId	string	是	标签 ID。

请求参数

名称	类型	必填	说明
profile_ids	string[]	否	环境 ID 列表。

修改标签

接口地址

PATCH /openapi/v2/tags/{tagId}

用于修改标签名称或颜色。

路径参数

名称	类型	必填	说明
tagId	string	是	标签 ID。

请求参数

名称	类型	必填	说明
name	string	否	标签名称。
style	string	否	标签颜色：gray、red、orange、yellow、green、teal、blue、purple、pink。

删除标签

接口地址

DELETE /openapi/v2/tags/{tagId}

用于删除标签。

路径参数

名称	类型	必填	说明
tagId	string	是	标签 ID。