API接口文档

通过底层编辑客户企业标签

POST

/api/v2/tag/mark

功能说明：

本接口基于RPA底层能力使用托管账号对指定用户新增或删除指定企业标签

📌

add_tag和remove_tag不可同时为空。
同一个标签组下现已支持多个标签

请求参数

Query 参数

token

string

调用接口凭证

必需

示例值:

***

Body 参数application/json

imBotId

string

托管账号的imBotId

必需

和botUserId二选一

externalUserId

string

客户企微外部联系人id

必需

botUserId

string

托管账号的企微员工id

必需

addTagId

array[string]

需要打上的系统标签id

必需

最多传10个

removeTagId

array[string]

需要删除的系统企微标签id

必需

最多传10个

示例

{
    "imBotId": "string",
    "externalUserId": "string",
    "botUserId": "string",
    "addTagId": [
        "string"
    ],
    "removeTagId": [
        "string"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v2/tag/mark?token=***' \
--header 'Content-Type: application/json' \
--data-raw '{
    "imBotId": "string",
    "externalUserId": "string",
    "botUserId": "string",
    "addTagId": [
        "string"
    ],
    "removeTagId": [
        "string"
    ]
}'

返回响应

🟢200成功

application/json

Body

errcode

enum<integer>

返回码

必需

枚举值:

400101400100400300400200

errmsg

string

对返回码的文本描述内容

必需

示例

{
    "errcode": 400101,
    "errmsg": "string"
}

删除标签

获取企业内各小组托管账号信息