新增好友标签 - 尘锋SCRM开放平台

POST https://qw-openapi-tx.dustess.com/open-integration-api/tag/v1/qwTag/add?accessToken=

Content-Type: application/json

接口限制：每分钟调用600次；

请求参数

请求参数名	类型	说明	是否必须
groupId	`String`	好友标签组id（如果不传，则系统将根据groupName新增分组码，与groupName不能同时为空）	false
groupName	`String`	好友标签组名称（最长为30个字符, 存在groupID的情况不用此字段无效，与groupId不能同时为空）	false
order	`Int`	标签组次序值。order值大的排序靠前，不传默认为0。有效的值范围是[0, 2^32)	false
tag	`Object[]`	好友标签列表（单次最多100个）	true
tag.name	`String`	好友标签名称（最长为30个字符）	true
tag.order	`Int`	标签组次序值。order值大的排序靠前，不传默认为0。有效的值范围是[0, 2^32)	false

请求参数示例
json - Request-Example1:

{
    "groupId": "etMXXWDQAAuAHdAub4i-OZwmimhLjXvg",
    "groupName": "",
    "order": 2,
    "tag": [
        {
            "name": "测试标签名称",
            "order": 1
        }
    ]
}

成功响应

响应参数名	类型	说明
code	`Int`	响应码 0:成功
msg	`String`	消息提示
success	`Bool`	请求成功与否
data	`Object`	企微操作结果数据
data.errcode	`Int`	企微操作结果错误码 0:成功
data.errmsg	`String`	企微操作结果错误信息
data.tag_group	`Object`	标签组信息
data.tag_group.create_time	`Int`	标签组创建时间
data.tag_group.deleted	`Bool`	标签组是否删除
data.tag_group.group_id	`String`	标签组id
data.tag_group.group_name	`String`	标签组名称
data.tag_group.order	`Int`	标签组排序值
data.tag_group.type	`String`	标签类型
data.tag_group.tag	`Object[]`	好友标签列表信息
data.tag_group.tag.create_time	`Int`	好友标签创建时间
data.tag_group.tag.deleted	`Bool`	好友标签是否删除
data.tag_group.tag.id	`String`	好友标签Id
data.tag_group.tag.name	`String`	好友标签名称
data.tag_group.tag.order	`Int`	好友标签排序值
traceId	`String`	跟踪id

成功响应示例

{
    "success": true,
    "code": 0,
    "msg": "ok",
    "data": {
        "errcode": 0,
        "errmsg": "ok",
        "tag_group": {
            "create_time": 1684836846,
            "deleted": false,
            "group_id": "etMXXWDQAAuAHdAub4i-OZwmimhLjXvg",
            "group_name": "openAPI专用",
            "order": 0,
            "type": "",
            "tag": [{
                "create_time": 1684840186,
                "deleted": false,
                "id": "etMXXWDQAAdc09chQFrN3s5gy5OnJj3g",
                "name": "3号",
                "order": 2
            }]
        }
    },
    "trace_id": "c5b491a6-6d76-40c8-b3ad-352fea509867"
}

错误响应示例

 {
    "success": false,
    "code": 10001,
    "msg": "system unknown error",
    "data": null
}