查询标签列表

最近更新时间:2018-08-07 16:57:15

接口描述

查询标签列表 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
        }
    ]
}