新增联系人标签值 - 尘锋SCRM开放平台

POST https://qw-openapi-tx.dustess.com/tag/v2/bizTag/add?accessToken=

Content-Type: application/json

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

请求参数

请求参数名	类型	说明	是否必须
groupID	`String`	联系人标签分组id	true
names	`String[]`	新增联系人标签名称（1、单次最多提交50个；2、同一标签组下标签总量不得超过50个；3、单个名称长度不能超过15个字符）	true
enable	`Bool`	标签状态（true:启用 false:禁用，不传默认false）	false

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

{
    "enable": true,
    "groupID": "bd1d7cfd-5b26-11ed-8f21-227b3b68a619",
    "names": [
        "新增联系人标签测试7",
        "新增联系人标签测试8"
    ]
}

成功响应

响应参数名	类型	说明
code	`Int`	响应码 0:成功
msg	`String`	消息提示
success	`Bool`	请求成功与否
data	`Object`	数据信息
data.successList	`Object[]`	处理成功列表
data.successList.id	`String`	联系人标签id
data.successList.name	`String`	联系人标签名称
data.repeatedList	`Object[]`	处理失败列表
data.repeatedList.id	`String`	联系人标签id
data.repeatedList.name	`String`	联系人标签名称
traceId	`String`	跟踪id

成功响应示例

{
    "code": 0,
    "data": {
        "code": 0,
        "msg": "",
        "repeatedList": [],
        "successList": [
            {
                "id": "055be604-e814-42dc-a7db-078d3a15d1b6",
                "name": "新增联系人标签测试7"
            },
            {
                "id": "c388ec5b-6d1c-4244-a350-882dd6c52852",
                "name": "新增联系人标签测试8"
            }
        ]
    },
    "msg": "OK",
    "success": true,
    "traceId": "58410e3e-ea0c-958a-af02-f9b2f8377e1e"
}

错误响应示例

{
    "code": 0,
    "data": {
        "code": 20110249,
        "msg": "标签名称重复",
        "repeatedList": [
            {
                "id": "c388ec5b-6d1c-4244-a350-882dd6c52852",
                "name": "新增联系人标签测试8"
            },
            {
                "id": "055be604-e814-42dc-a7db-078d3a15d1b6",
                "name": "新增联系人标签测试7"
            }
        ],
        "successList": []
    },
    "msg": "OK",
    "success": true,
    "traceId": "2475d644-733f-9ea7-ae86-68baad9be9d9"
}