创建标签

POST

/api/v1/tag/create

功能说明：

本接口用于创建指定标签组内容的im企业标签，通过传入im企业标签组ID、和新建的标签名称完成创建。

该接口需要安装自建应用后才可以使用。

💡

1.如果要向指定的标签组下添加标签，需要填写group_id参数；
2.如果要创建一个全新的标签组以及标签，则需要通过group_name参数指定新标签组名称，如果填写的groupname已经存在，则会在此标签组下新建标签。
3.如果填写了group_id参数，则group_name参数会被忽略。
4.不支持创建空标签组。
5.标签组内的标签不可同名，如果传入多个同名标签，则只会创建一个。

请求参数

Query 参数

Body 参数application/json

示例

{
    "groupId": "etrRhyBgAA2W19wNHbGDNB1vWkwZkhUA",
    "groupName": "asd",
    "tag": [
        {
            "name": "测试"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://zan-hub.xiaoshunai.com/api/v1/tag/create?token=d12195ec829f4********9e79f1c0bc7' \
--header 'Content-Type: application/json' \
--data-raw '{
    "groupId": "etrRhyBgAA2W19wNHbGDNB1vWkwZkhUA",
    "groupName": "asd",
    "tag": [
        {
            "name": "测试"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{"errcode":0,"errmsg":"ok","data":{"id":"etrRhyBgAA2W19wNHbGDNB1vWkwZkhUA","name":"0429标签组","createTimestamp":1745913117000,"order":0,"tag":[{"id":"etrRhyBgAA2gZGg7VJAXp0k4T1ckOC3w","name":"测试","createTimestamp":1751616230000,"order":0}]}}

修改于 2025-07-17 12:11:42

获取标签详情

修改标签组