接口描述
查询标签列表 GetTags 用于查询已建立的标签列表。
请求域名:tag.api.qcloud.com
输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
createUin | 否 | int | 创建者用户uin,不传或为空只将uin作为条件查询 |
page | 否 | int | 页码,默认为 1 |
rp | 否 | int | 每页大小,默认为 15 |
tagKey | 否 | String | 标签键,与标签值同时存在或同时不存在,不存在时表示查询该用户所有标签 |
tagValue | 否 | String | 标签值,与标签键同时存在或同时不存在,不存在时表示查询该用户所有标签 |
输出参数
参数名称 | 类型 | 描述 |
---|---|---|
total | int | 结果总数 |
page | int | 当前页码 |
rp | int | 每页大小 |
rows | Array | 标签列表 |
其中 rows 数组的参数如下:
参数名称 | 类型 | 描述 |
---|---|---|
tagKey | String | 标签键 |
tagValue | String | 标签值 |
canDelete | int | 能否删除,该标签绑定资源是不能删除 |
错误码
错误码 | 描述 |
---|---|
30004 | 主账号 Uin 不存在 |
示例
输入示例
https://domain/v2/index.php?Action=GetTags&tagKey=testTagKey&tagValue=testTagVal&<公共请求参数>
输出示例
{
"total": 1,
"page": "1",
"rp": "15",
"rows": [
{
"tagKey": "testTagKey",
"tagValue": "testTagVal",
"canDelete": 0
}
]
}