# 好友去重模块接口文档
##### 作者：黄文榕
##### 时间：2020-05-07
##### 版本：V4.2.0
##### 修改：
|更新时间|更新人|作用|
|--|--|--|
### 新增去重任务接口
- url: /wechat_api/repetionFriend/start
- 调用方式： post
##### 作用：
新增去重任务接口
##### 传参:
属性名 | 类型| 是否必要 | 备注
---|--- |---| ---
uins | List<String> | Y | 传入的微信号
departStruct | String | N | 传入当时的部门结构
```
{
"uins":["1575045774","2245246006"]
}
```
##### 出参：
属性名 | 类型| 备注
---|--- | ---
code | Integer |
msg | String |
data | {} | 数据
data：
属性名 | 类型| 备注
---|--- | ---
repetionFriendId | Integer | 去重任务的id
status | Integer | 任务处于的状态（0:进行中 1:完成 4:失败）
adminUserId |Integer | 账号id
repetionFriendNum | Integer | 重复好友数量
createTime | String | 创建时间
departStruct | String | 部门结构
```
{
"code": 200,
"msg": "操作成功!",
"data": {
"repetionFriendId": 32,
"status": 0,
"adminUserId": 14,
"repetionFriendNum": 0,
"createTime": "2020-05-07 13:59:03",
"departStruct": null
}
}或
{
{
"code": 400,
"msg": "uin至少填入1个最多填入100个"/"uins不能为空",
"data": null
}
```
##### 异步推送：
属性名 | 类型| 备注
---|--- | ---
MTYPE | String | 好友去重完成为： reFriend
content | Map | noticeMessage
content
adminUserId | Long | 用户Id
content | String | 内容
msgCode | Integer | 提醒类型 好友去重完成为：3
isRead | Integer | 是否阅读
createTime | time | 创建时间
title | String | 标题
### 查询任务列表（分页）
- url: /wechat_api/repetionFriend/page
- 调用方式： get
##### 作用：
查询任务列表
##### 传参:
属性名 | 类型| 是否必要 | 备注
---|--- |---| ---
limit | Integer | Y | 限制数
pageNo | Integer | Y | 页码
status | Integer | N | 状态（0:进行中 1:完成 4:失败）
```
/wechat_api/repetionFriend/page?limit=10&pageNo=1
```
##### 出参：
属性名 | 类型| 备注
---|--- | ---
code | Integer |
msg | String |
data | map | 数据
data：
属性名 | 类型| 备注
---|--- | ---
count | Integer | 总数
data | list |数据
pageNo | Integer | 页码
limit | Integer | 限制数
data.data:
属性名 | 类型| 备注
---|--- | ---
repetionFriendId | Integer | 去重任务的id
status | Integer | 任务处于的状态
adminUserId |Integer | 账号id
repetionFriendNum | Integer | 重复好友数量
createTime | String | 创建时间
departStruct | String | 部门结构
repetionFriendUinVOS | list | 微信号详情
data.data.repetionFriendUinVOS:
属性名 | 类型| 备注
---|--- | ---
uin | String | uin
headImgUrl |String | 头像链接
nickName | String | 个性昵称 |
departId | Integer | 部门id
```
{
"code": 200,
"msg": "操作成功!",
"data": {
"count": 12,
"data": [
{
"repetionFriendId": 35,
"status": 1,
"adminUserId": 14,
"repetionFriendNum": 57,
"createTime": "2020-05-07 15:26:37",
"repetionFriendUinVOS": [
{
"uin": "1575045774",
"headImgUrl": "http://wx.qlogo.cn/mmhead/ver_1/usSaGQ4wCY6892IYfUqecKHopsicHgIER5Dib5kP7wIUb5AIq369RicGHlLG8QBau9kkA2HNTjOxYFzbvqgbYvrBUicRjSWu4wQrFyW4d8TgWCM/0",
"nickName": "你看那山花烂漫",
"departId": null
},
{
"uin": "2245246006",
"headImgUrl": "http://wx.qlogo.cn/mmhead/ver_1/QO4juXsibLFA1Fic1Ou52Kd2BRUwQxq5zGaGoxuf4YdmsG2GwLTsmjLiaVV0OibtjaB8yoibQ535niabLJnp2I1lP1weQSib1DUUUeYavw5VCic6PtY/0",
"nickName": "undefine",
"departId": null
},
{
"uin": "2368771701",
"headImgUrl": "http://wx.qlogo.cn/mmhead/ver_1/JRmibsM00VpaVK8BoDcSsdmxr5aiaZXaVicyKLRjICoFymNfoCeGC3YqfNzAV9lacAUpY0LgeYficicv34vMKq7hkcIia0evUWyViaOzjBZ1598z5w/0",
"nickName": "小争小吵小任性。",
"departId": null
}
]
}
],
"pageNo": 1,
"limit": 1
}
}
或
{
{
"code": 400,
"msg": "limit不为空"/"pageNo不为空",
"data": null
}
```
### 删除去重任务接口
- url: /wechat_api/repetionFriend/delete
- 调用方式： post
##### 作用：
删除去重任务
##### 传参:
属性名 | 类型| 是否必要 | 备注
---|--- |---| ---
ids | List | Y | 删除ID
```
[20]
```
##### 出参：
属性名 | 类型| 备注
---|--- | ---
code | Integer |
msg | String |
data | {} | 数据
```
{
"code": 200,
"msg": "刪除成功",
"data": null
} 或 {
"code": 400,
"msg": "删除任务必须在1到10以内",
"data": null
}
```
### 删除去重任务详情接口
- url: /wechat_api/repetionFriendDetails/delete
- 调用方式： post
##### 作用：
删除去重任务详情
##### 传参:
属性名 | 类型| 是否必要 | 备注
---|--- |---| ---
ids | List | Y | 删除ID
```
[241,242]
```
##### 出参：
属性名 | 类型| 备注
---|--- | ---
code | Integer |
msg | String |
data | {} | 数据
```
{
"code": 200,
"msg": "刪除成功",
"data": null
} 或 {
"code": 400,
"msg": "删除任务必须在1到10以内",
"data": null
}
```
##### 异步推送：
属性名 | 类型| 备注
---|--- | ---
MTYPE | String | 好友去重完成为： delReFriend
content | Map | noticeMessage
content
adminUserId | Long | 用户Id
content | String | 内容
msgCode | Integer | 提醒类型 好友去重完成为：4
isRead | Integer | 是否阅读
createTime | time | 创建时间
title | String | 标题
### 查询任务详情列表（分页）
- url: /wechat_api/repetionFriendDetails/userNamePage
- 调用方式： get
##### 作用：
查询任务详情列表
##### 传参:
属性名 | 类型| 是否必要 | 备注
---|--- |---| ---
limit | Integer | Y | 限制数
pageNo | Integer | Y | 页码
repetionFriendId | Integer | Y | 任务id
```
/userNamePage?limit=10&pageNo=1&repetionFriendId=24
```
##### 出参：
属性名 | 类型| 备注
---|--- | ---
code | Integer |
msg | String |
data | map | 数据
data：
属性名 | 类型| 备注
---|--- | ---
count | Integer | 总数
data | list |数据
pageNo | Integer | 页码
limit | Integer | 限制数
data.data
属性名 | 类型| 备注
---|--- | ---
nickName | String | 昵称
userName | String | userName
count | Integer | 总数
headImgUrl | String | 头像
```
{
"code": 200,
"msg": "操作成功!",
"data": {
"count": 35,
"data": [
{
"nickName": "st.c",
"userName": "cc5200cc",
“headImgUrl”:""
"count": 2
}
],
"pageNo": 1,
"limit": 1
}
}
或
{
{
"code": 400,
"msg": "limit不为空"/"pageNo不为空"/"repetionFriendId不能为空",
"data": null
}
```
### 查询任务微信号详情列表（分页）
- url: /wechat_api/repetionFriendDetails/page
- 调用方式： get
##### 作用：
查询任务微信号详情列表
##### 传参:
属性名 | 类型| 是否必要 | 备注
---|--- |---| ---
limit | Integer | Y | 限制数
pageNo | Integer | Y | 页码
repetionFriendId | Integer | Y | 任务id
userName | String | Y | user_name
```
/page?limit=10&pageNo=1&repetionFriendId=24&userName=wxid_15s48dvw9f7s22
```
##### 出参：
属性名 | 类型| 备注
---|--- | ---
code | Integer |
msg | String |
data | map | 数据
data：
属性名 | 类型| 备注
---|--- | ---
count | Integer | 总数
data | list |数据
pageNo | Integer | 页码
limit | Integer | 限制数
data.data
属性名 | 类型| 备注
---|--- | ---
repetionFriendDetailId | Integer |
uin | String | uin
userName | String | userName
nickName | String | 微信号昵称
remarkName | String | 备注
tags | String | 标签
customerNickName | String | 个性昵称
lastMessageTime | String | 最后回复时间
messageCount | String | 消息总数
addTime | String | 添加时间
status | Integer | 在线状态 0：不在线 1在线
wechatNickName | String | 微信号昵称 |
```
{
"code": 200,
"msg": "操作成功!",
"data": {
"count": 2,
"data": [
{
"repetionFriendDetailId": 480,
"uin": "1575045774",
"userName": "wxid_15s48dvw9f7s22",
"nickName": "小争小吵小任性。",
"remarkName": "小琳",
"tags": null,
"customerNickName": "小琳",
"messageCount": "0",
"lastMessageTime": null,
"addTime": null
},
{
"repetionFriendDetailId": 515,
"uin": "2245246006",
"userName": "wxid_15s48dvw9f7s22",
"nickName": "小争小吵小任性。",
"remarkName": "小琳222",
"tags": null,
"customerNickName": null,
"messageCount": "0",
"lastMessageTime": null,
"addTime": "2020-04-27 17:37:37.0"
}
],
"pageNo": 1,
"limit": 10
}
}
或
{
{
"code": 400,
"msg": "limit不为空"/"pageNo不为空"/"repetionFriendId不能为空"/"userName不能为空",
"data": null
}
```
- 首页
- 系统登录注册模块
- 登录模块
- 注册模块
- 忘记密码模块
- 功能首页渲染模块
- 会话面板模块
- 微信号登录模块
- 会话联系人模块
- 通讯录模块
- 聊天窗口模块
- 快捷回复模块
- 客户录入模块
- 群管理模块
- 历史消息面板模块
- 群发助手面板模块
- 群发设置模块
- 群发管理模块
- 群发演示模块
- 朋友圈面板模块
- 发朋友圈模块
- 朋友圈互动模块
- 朋友圈历史记录模块
- 客户管理面板模块
- 客户查询模块
- 服务记录模块
- 批量标签模块
- 标签管理模块
- 昵称管理模块
- 个性称呼模块
- 批量导入客户模块
- 报表面板模块
- 微信好友报表
- 被删好友报表
- 新增好友报表
- 添加好友报表
- 服务记录报表
- 转账记录报表
- 红包统计报表
- 会话统计报表
- 电话统计报表
- 标签统计报表
- 账号管理面板模块
- 微信号管理模块
- 部门管理模块
- 子账号管理模块
- 在线日志模块
- 机器人模块
- 自动通过好友模块
- 小程序商城模块
- 微信号分配模块
- 帮助中心面板模块
- 个人中心模块
- 我的账号模块
- 系统设置模块
- 第三方能力接口对接
- 第三方登录模块
- 联系人模块
- 系统账号模块
- 服务版本接口迭代说明
- 素材库
- 好友去重
- V群模块