[废弃]创建标签

[异步回调]创建标签

【提示】建议直接使用企微自建应用，调用企微开平接口

企业微信的标签分为2种，一种为企业标签，一种个人标签。 个人标签由企业成员创建，只可面向个人使用。

注意： 1. 该接口创建的标签为个人标签，并非企业标签

请求方式：POST

请求地址：https://$basehost/gateway/qopen/AddRobotTag

body参数：

{
    "robot_id": "机器人id",
    "tag_name": "标签名称"
}

字段	类型	必填	说明
robot_id	string	是	机器人id
tag_name	string	是	标签名称

返回值：

{
    "data": {
        "serial_no": "操作序列号"
    },
    "errcode": 0,
    "errmsg": "",
    "hint": ""
}

返回说明

字段	类型	说明
errcode	int	状态码，0为正常，非0代表错误
errmsg	string	错误信息
data	json	json返回值
serial_no	string	操作序列号
hint	string	请求日志ID

处理结果，异步返回值：

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

返回说明

字段	类型	说明
event_type	int	事件类型，702002
serial_no	string	操作序列号
err_code	int	状态码，0为正常，非0代表错误
err_msg	string	错误信息
robot_id	string	机器人id
data	object	返回数据
data.tag	object	标签结构体
data.tag.tag_id	string	标签id
data.tag.tag_name	string	标签名称
data.tag.base64_tag_name	string	base64加密后的标签名称
data.tag.tag_type	int	标签类型：1企业标签；2个人标签
data.tag.add_time	string	标签的添加时间

完整请求示例：

curl -X POST https://$basehost/gateway/qopen/AddRobotTag \
     -H 'Content-Type: application/json; charset=UTF-8' \
     -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
     -d '{
            "robot_id": "机器人id",
            "tag_name": "标签名称"
         }'