请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/tag/addtagusers?access_token=ACCESS_TOKEN
请求包体:
{
"tagid": 12,
"userlist":[ "user1","user2"],
"partylist": [4]
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
tagid | 是 | 标签ID |
userlist | 否 | 企业成员ID列表,注意:userlist、partylist不能同时为空,单次请求个数不超过1000 |
partylist | 否 | 企业部门ID列表,注意:userlist、partylist不能同时为空,单次请求个数不超过100 |
权限说明:
调用的应用必须是指定标签的创建者;成员属于应用的可见范围。
注意,每个标签下部门数和人员数总和不能超过3万个。
返回结果:
a)正确时返回
{
"errcode": 0,
"errmsg": "ok"
}
b)若部分userid、partylist非法,则返回
{
"errcode": 0,
"errmsg": "ok",
"invalidlist":"usr1|usr2|usr",
"invalidparty":[2,4]
}
c)当包含userid、partylist全部非法时返回
{
"errcode": 40070,
"errmsg": "all list invalid "
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
invalidlist | 非法的成员账号列表 |
invalidparty | 非法的部门id列表 |