# 获取标签

[异步回调]获取标签

企业微信的标签分为2种,一种为企业标签,一种个人标签。

企业标签分为标签组(标签组的名称以及该组别下的标签名称),由企业管理员设置,普通成员不可编辑修改,可面向企业内所有成员使用。

个人标签由企业成员创建,只可面向个人使用。

注:若当前机器人无客户联系及客户群权限,无法查看企业标签。可以获取到个人创建的标签

请求方式:POST

请求地址:https://api.aquanliang.com/gateway/qopen/GetRobotTags

body参数

{
    "robot_id": "机器人id"
}
字段 类型 必填 说明
robot_id string 机器人id

返回值:

{
    "data": {
        "serial_no": ""
    },
    "errcode": 0,
    "errmsg": ""
}

返回说明

字段 类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
serial_no string 操作序列号

处理结果,异步返回值:

{
    "event_type": 702001,
    "serial_no": "操作序列号",
    "robot_id": "机器人id",
    "err_code": 0,
    "err_msg": "success",
    "data": {
        "tags": [
            {
                "parent_tag_name": "标签组名称",
                "child_tags": [
                    {
                        "tag_id": "标签id",
                        "tag_name": "标签名称",
                        "base64_tag_name": "base64加密后的标签名称",
                        "tag_type": 1,
                        "add_time": "标签的添加时间"
                    }
                ]
            }
        ]
    }
}

返回说明

字段 类型 说明
event_type int 事件类型,702001
serial_no string 操作序列号
err_code int 状态码,0为正常,非0代表错误
err_msg string 错误信息
robot_id string 机器人id
data object 返回数据
data.tags array 标签列表
data.tags[x].parent_tag_name string 标签组名称,用于展示企业标签组的名称及个人标签标识
data.tags[x].child_tags array 子标签列表
data.tags[x].child_tags[x].tag_id string 标签id
data.tags[x].child_tags[x].tag_name string 标签名称
data.tags[x].child_tags[x.].base64_tag_name string base64加密后的标签名称
data.tags[x].child_tags[x].tag_type int 标签类型:1企业标签;2个人标签
data.tags[x].child_tags[x].add_time string 标签的添加时间

完整请求示例:

curl -X POST https://api.aquanliang.com/gateway/qopen/GetRobotTags \
     -H 'Content-Type: application/json; charset=UTF-8' \
     -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
     -d '{
             "robot_id": "机器人id"
         }'