增加标签成员

POST

http://127.0.0.1/cgi-bin/tag/addtagusers

智慧硬件开发/通讯录管理/标签管理

最后修改时间：2022-08-30 03:03:36

责任人：未设置

权限说明：调用的应用必须是指定标签的创建者；成员属于应用的可见范围。
注意，每个标签下部门数和人员数总和不能超过3万个。
文档ID: 10923
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/90214
https://open.work.weixin.qq.com/api/doc/90001/90143/90350
https://open.work.weixin.qq.com/api/doc/90002/90151/90833

请求参数

Query 参数

access_token

string

必需

示例值:

Body 参数application/json

userlist

array[string]

可选

企业成员ID列表，注意：userlist、partylist不能同时为空，单次请求个数不超过1000

partylist

array[integer]

可选

企业部门ID列表，注意：userlist、partylist不能同时为空，单次请求个数不超过100

tagid

integer <int32>

标签ID

必需

示例

{
  "tagid": 12,
  "userlist": [
    "user1",
    "user2"
  ],
  "partylist": [
    4
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/tag/addtagusers?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "tagid": 12,
    "userlist": [
        "user1",
        "user2"
    ],
    "partylist": [
        4
    ]
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

invalidlist

string

非法的成员帐号列表

可选

invalidparty

array[integer]

可选

非法的部门id列表

示例

{
  "errcode": 0,
  "errmsg": "string",
  "invalidlist": "string",
  "invalidparty": [
    0
  ]
}

获取标签成员

删除标签成员