添加标签

POST

/api/v3/tags/add

添加企业标签。标签组名和标签组id至少要提供一项。同时提供时以标签组id为准。如果只传入企业标签组名称，未有该标签组名称时，将会创建该企业标签组。

注：企微限制每个企业最多可配置3000个企业标签。

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

qwGroupId

string

企业标签组企微id

可选

qwGroupName

string

企业标签组名称

可选

tagName

string

新标签名称

必需

标签名最多30个UTF-8字符

示例

{
    "qwGroupId": "etvRo3DwAAk43mdAhThqs5xLJPAwrSNw",
    "qwGroupName": "除高其儿儿情",
    "tagName": "前区准场"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/tags/add' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "qwGroupId": "etvRo3DwAAk43mdAhThqs5xLJPAwrSNw",
    "qwGroupName": "除高其儿儿情",
    "tagName": "前区准场"
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

message

string

结果说明

必需

data

object

添加的标签、标签组id

必需

qwGroupId

string

企业标签组企微id

必需

qwTagId

string

企业标签企微id

必需

示例

{
    "code": 0,
    "message": "ok",
    "data": {
        "qwGroupId": "etvRo3DwAAG4HDEb6TU7B8qjz55HiBIw",
        "qwTagId": "etvRo3DwAA5D9PrcMrayLrPrOBqa-72A"
    }
}

🟢200异常

修改于 2022-12-06 11:03:20

删除标签组

编辑标签