给联系人打标签
编辑联系人好友标签和联系人标签,通过该接口新增和移除联系人的好友标签和联系人标签
POST https://qw-openapi-tx.dustess.com/open-integration-api/customer/v1/updateTags?accessToken=
Content-Type: application/json
字段 | 类型 | 描述 | 是否必须 |
---|---|---|---|
accessToken | String | accessToken | true |
请求参数名 | 类型 | 说明 | 是否必须 |
---|---|---|---|
list | Object[] | 更新数据列表,最多500条 | true |
list.customerId | String | 联系人id | true |
list.tags | Object | 更新的好友标签信息(与联系人标签不能同时为空) | false |
list.tags.add | String[] | 添加的好友标签id列表 | false |
list.tags.remove | String[] | 移除的好友标签id列表 | false |
list.bizTags | Object | 更新的联系人标签信息(与好友标签不能同时为空) | false |
list.bizTags.add | String[] | 添加的联系人标签id列表 | false |
list.bizTags.remove | String[] | 移除的联系人标签id列表 | false |
json
- Request-Example1:{
"list": [{
"customerId": "b5a48cc7-d94d-11eb-8a97-ee6659fc100f",
"tags": {
"add": ["bc8aea7c-6fc5-11ed-bdab-1e80c02e3484"],
"remove": []
},
"bizTags": {
"add": [],
"remove": ["bc8aea7c-6fc5-11ed-bdab-1e80c02e3484"]
}
}]
}
响应参数名 | 类型 | 说明 |
---|---|---|
code | Int | 响应码 0:成功 |
msg | String | 消息提示 |
success | Bool | 请求成功与否 |
data | Object[] | 数据信息 |
data.id | String | 联系人id |
data.code | String | 操作结果码 0:成功 |
data.msg | String | 操作结果提示 |
{
"code": 0,
"success":true,
"msg":"",
"data":[
{
"id":"5f61784904a7059c9c111111",
"code":0,
"msg":"success"
},
{
"id":"5f61784904a7059c9c111112",
"code":20070408,
"msg":"联系人好友标签不存在"
}
]
}
{
"success": false,
"code": 10001,
"msg": "system unknown error",
"data": null
}
修改于 2024-09-24 11:03:06