删除联系人
1、支持删除已关联好友的联系人数据,删除后会进入回收站;
2、在回收站的联系人数据被清空之前,好友与该联系人的关联关系会保留;
3、存在回收站的联系人数据不参与新增联系人时的手机号判重;
POST https://qw-openapi-tx.dustess.com/customer/v1/batchDelCustomer?accessToken=
Content-Type: application/json
接口限制:每分钟调用600次;单次最大限制1000;
注:当参数ids和external_ids,同时传参,默认以ids进行删除
请求参数
请求参数名 | 类型 | 说明 | 是否必须 |
---|---|---|---|
ids | String[] | 删除的尘锋联系人id(一次最多成功删除1000条数据,和external_ids二选一必填) | false |
external_ids | String[] | 删除的外部联系人id,(一次最多成功删除1000条数据,和ids二选一必填) | false |
reason | String | 删除的原因id | true |
请求参数示例
json
- Request-Example:
{
"ids": [
"05457748-2045-11ef-826e-3ed2e9339d6d"
],
"reason": "22222"
}
成功响应
响应参数名 | 类型 | 说明 |
---|---|---|
success | Bool | 请求状态,true:成功,false:失败_Allowed values: true,false_ |
code | Int | 响应代码 |
msg | String | 消息提示 |
data | Object | 数据信息 |
data.fail | Object | 删除失败的联系人 |
成功响应示例
{
"success": true,
"msg": "",
"data": {
"fail": null
}
}
错误响应示例
{
"success": false,
"code": 4126,
"msg": "",
"data": {
"fail": [{
"code": 13002,
"id": "a5511d68-be6b-11e9-9bbe-a11111111111111",
"external_id":"",
"msg":""
}]
}
}