编辑好友信息
批量编辑好友信息备注:包含好友标签、备注名称、电话信息;
例:一个好友添加了5个员工,形成5段好友关系,好友备注信息都是分配备注在单独的好友关系中
POST https://qw-openapi-tx.dustess.com/open-integration-api/friend/v1/batchEditFriendInfo?accessToken=
字段 | 值 |
---|---|
Content-Type | application/json |
字段 | 类型 | 描述 | 是否必须 |
---|---|---|---|
accessToken | String | accessToken | true |
请求参数名 | 类型 | 说明 | 是否必须 |
---|---|---|---|
list | Object[] | 编辑列表(最大支持100个) | true |
list.uid | String | 员工编号 | true |
list.externalUserId | String | 外部联系人id | true |
list.mobiles | String[] | 电话列表(与remark和tags字段至少传一个,清空电话请传[""] ) | false |
list.remark | String | 好友备注(与mobiles和tags字段至少传一个,若不修改备注请去掉此字段,备注不支持空字符串) | false |
list.tags | Object[] | 好友标签列表(与mobiles和remark字段至少传一个,清空标签请传[{}] ) | false |
list.tags.id | String | 好友标签(id | true |
list.tags.type | Int | 好友标签类型(1:好友标签 ) | true |
json
- Request-Example:{
"list": [
{ "uid":"10145",
"mobiles": [
"13300120043"
],
"externalUserId": "wmXvtYBgAAcs9baTK8G77YsnGtV6OZAQ",
"remark":"修改备注名",
"tags":[
{
"id": "etXvtYBgAAQ5hgdCDaXcbco0VkSM6GZg",
"type": 1
}
]
}
]
}
响应参数名 | 类型 | 说明 |
---|---|---|
code | Int | 响应码,0:成功 |
msg | String | 消息提示 |
success | Bool | 成功标识 |
data | Object | 响应码 |
data.successList | Object[] | 编辑成功列表 |
data.successList.uid | String | 员工id |
data.successList.externalUserId | String | 外部联系人id |
data.failList | Object[] | 编辑失败列表 |
data.failList.uid | String | 员工id |
data.failList.externalUserId | String | 外部联系人id |
data.failList.code | Int | 错误码 |
data.failList.msg | String | 错误描述 |
{
"success": true,
"code": 0,
"msg": "",
"data": {
"successList": [
{
"uid": "10145",
"externalUserId": "wmXvtYBgAAcs9baTK8G77YsnGtV6OZAQ"
}
],
"failList": []
}
}
{
"success": false,
"code": 40020,
"msg": "param enable error ex:0|1|2",
"data": {}
}