# 微信號管理模塊 |更新時間|更新人|作用| |--|--|--| 2020-05-22 | 李小琳 | 根據V4.3.0 增加查詢部門樹下微信號接口 ## **Web端交互** > *****  ## **API相關文檔** > ****** - API infomation 接口描述 | **獲取系統賬號下的微信號信息** ---|--- URL | /wechat_api/wechatPool/searchWechatUser 請求方式 | get 請求參數 | ?realName=&nickName=&status=&type=2 - params infomation | Sort | Param | Type | required | Description | | --- | --- | --- | --- |--- | | 請求參數 | realName | string | Y |系統賬號名稱（管理員有權限其子賬號的微信號信息） | 請求參數 | status | Integer | Y |微信號在線狀態{1:在線；0:離線} | 請求參數 | nickName | string | Y |微信號昵稱 | 請求參數 | type | string | Y |值默認為2 - response example ``` { "msg":"獲取成功", "code":200, "data":\[ ????????{ ????????????"wechatUserId":67, ????????????"uin":"2123131667", ????????????"userName":"wxid\_lbejkr1i6jl922", ????????????"nickName":"呵呵海", ????????????"headImgUrl":"[http://wx.qlogo.cn/mmhead/ver\_1/Eo51yzdqojt7g5I2uNlaCsLNGqrsCsKBnbuZ6P8pK3iaHtrqRB11zQPxxMibAZOTkQW9RdEkiacLoGorFns7IWuNn4gxGH4Y7R2bibjQ4Pcibpn4/0](http://wx.qlogo.cn/mmhead/ver_1/Eo51yzdqojt7g5I2uNlaCsLNGqrsCsKBnbuZ6P8pK3iaHtrqRB11zQPxxMibAZOTkQW9RdEkiacLoGorFns7IWuNn4gxGH4Y7R2bibjQ4Pcibpn4/0)", ????????????"remarkName":null, ????????????"remarkPYInitial":null, ????????????"remarkPYQuanPin":null, ????????????"sex":null, ????????????"status":1, ????????????"verifyFlag":"0", ????????????"adminUserId":1, ????????????"createTime":null, ????????????"lastLoginTime":1578576224000, ????????????"lastLoginIP":"/events/PC/1", ????????????"secName":null, ????????????"flag":null, ????????????"wechatMeta":null, ????????????"serverId":"Ipad\_001", ????????????"childId":"04", ????????????"mqServerId":"Ipad\_001\_04", ????????????"snsBg":null, ????????????"area":null, ????????????"signature":null, ????????????"phone":null, ????????????"bindQQ":null, ????????????"isAutoReply":0, ????????????"maxLimit":null, ????????????"adminUserRealName":"superadmin", ????????????"type":0, ????????????"pyinitial":null, ????????????"pyquanPin":null ????????} ????\] } ``` > ***** ? 接口描述 | **分配微信號** ---|--- URL | /wechat_api/wechatAssign/assign 請求方式 | post 請求參數 | {targetAdminUserId:"33726",wechatUser:[{"sourceAdminUserId":33726,"uin":"2964685533","wechatUserId":57221,"nickName":"小陶同學"}]} 返回值 | {"msg":"分配成功","code":200}? | Sort | Param | Type | required | Description | | --- | --- | --- | --- |--- | | 請求參數 | targetAdminUserId| Long| Y |分配的目標賬號ID | 請求參數 | sourceAdminUseId| string| Y |源賬號ID | 請求參數 | uin| string| Y |被分配的用戶微信ID | 請求參數 | wechatUserId| Long | Y |被分配的微信號ID（數據庫主鍵字段） | 請求參數 | nickName | string| Y |被分配的微信號昵稱 > ***** 接口描述 | **加入微信號碼池** ---|--- URL | /wechat_api/wechatPool/batchJoinPool 請求方式 | post 請求參數 | {wechatUserIds:"57221"，uins:"2964685533"} 返回值 |{"msg":"加入微信池成功","code":200} | Sort | Param | Type | required | Description | | --- | --- | --- | --- |--- | | 請求參數 | wechatUserIds| string | Y |要加入微信池的微信號ID(數據庫主鍵字段) | 請求參數 | uins| string | Y |要加入微信池的微信號ID > ***** 接口描述 | **查看微信池** ---|--- URL | /wechat_api/wechatPool/findJoins 請求方式 | get 請求參數 | {nickName:"陶成",online:"2"} 返回值 |[{"name":"陶成","wechatUser":{"wechatUserId":57221,"uin":"2964685533","userName":"wxid_mjxv8kbxje8b22","nickName":"小陶同學","headImgUrl":"http://wx.qlogo.cn/mmhead/ver_1/1YA7qsrPxCh7BeiacD1Yh6LFoQThxmb290PFZEo6Q3jkcJD5ibkLAOcrBIz44Ruzd0oibKEepFI1OkK5sfc1QicvNCgpOUhT2dgWk1yibL7giaoRs/0","status":1,"verifyFlag":"0","adminUserId":33726,"lastLoginTime":1564716060000,"lastLoginIP":"null","serverId":"Ipad_guangzhou_010","childId":"11","mqServerId":"Ipad_guangzhou_010_11"}}] | Sort | Param | Type | required | Description | | --- | --- | --- | --- |--- | | 請求參數 | nickName| string | Y |微信號昵稱 | 請求參數 | online| Interger| Y |是否在線 > ***** 接口描述 | **從微信池領取到當前賬號** ---|--- URL | /wechat\_api/wechatPool/batchReceive 請求方式 | post 請求參數 | {uins:"2964685533"} 返回值 |{"msg":"批量領取微信號成功","code":200} | Sort | Param | Type | required | Description | | --- | --- | --- | --- |--- | | 請求參數 | uins| string | Y |用戶微信ID > ***** 接口描述 | **從微信池撤回微信號** ---|--- URL | /wechat_api/wechatPool/removeFromPool 請求方式 | post 請求參數 | {wechatUserId:"57221"} 返回值 |{"msg":"從微信池撤回微信號","code":200} | Sort | Param | Type | required | Description | | --- | --- | --- | --- |--- | | 請求參數 | wechatUserId| Long| Y |微信號ID > ***** 接口描述 | **下線微信號** ---|--- URL | /wechat\_api/websocket/logout 請求方式 | post 請求參數 | {uin:"2964685533",loginer:"33726"} 返回值 |{{"msg":"下線成功","code":200} | Sort | Param | Type | required | Description | | --- | --- | --- | --- |--- | | 請求參數 | uin| string| Y |用戶微信ID | 請求參數 | loginer| Y |string|adminUserId帳號id > ***** 接口描述 | **刪除微信號** ---|--- URL | /wechat\_api/wechatuser/accountLogout 請求方式 | get 請求參數 | {uin:"2964685533",loginer:"33726"} 返回值 |{"msg":"登出成功！","code":200} | Sort | Param | Type | required | Description | | --- | --- | --- | --- |--- | | 請求參數 | uin| string| Y |用戶微信ID | 請求參數 | loginer| string| Y |adminUserId帳號id > ***** 接口描述 | **導出好友微信號** ---|--- URL | /wechat\_api/report/exportWechatFriendReport 請求方式 | get 請求參數 | {wechatNiceName:"售前-陶成",uin:"663329897"} 返回值 |{"msg":"已經收到您的下載請求，后臺正在生成，請稍后。","code":200} | Sort | Param | Type | required | Description | | --- | --- | --- | --- |--- | | 請求參數 | wechatNiceName| string| Y |導出的微信號昵稱 | 請求參數 | uin| string| Y |導出的用戶微信ID > ***** 接口描述 | **更新微信號加載狀態** ---|--- URL|/wechat_api/wechatuser/updateWechatUserLoadingStatus 請求方式 | get 請求參數 | uin 返回值 |{?code: 200?,msg : 修改成功} | Sort | Param | Type | required | Description | | --- | --- | --- | --- |--- | | 請求參數 | uin| string| Y |導出的用戶微信ID > ***** 接口描述 | **獲取微信號加載狀態** ---|--- URL|/wechat_api/wechatuser/updateWechatUserLoadingStatus 請求方式 | get 請求參數 | uin 返回值 |{?code: 200 data : //wechatUserLoadingStatus: + uin 中的數據 } | Sort | Param | Type | required | Description | | --- | --- | --- | --- |--- | | 請求參數 | uin| string| Y |導出的用戶微信ID > ***** 接口描述 | **根據公共池狀態搜索** ---|--- URL|/wechat_api/wechatPool/findByStatus 請求方式 | get 請求參數 | realName,type,nickName,status 返回值 | [{name:"譚煜辰",wechatUser:{wechatUserId:597,uin:"3180227369",...}}] | Sort | Param | Type | required | Description | | --- | --- | --- | --- |--- | | 請求參數 | nickName| string| N|微信號昵稱 | 請求參數 | status| string| N|狀態 | 請求參數 | realName| string| N|真實姓名 | 請求參數 | type| Interger| Y |類型 ### V4.3.0 查詢部門微信樹 - url: /wechat_api/wechatuser/findWeChatDataByDepartTree - 調用方式：get ##### 傳參： 屬性名 | 類型| 是否必要 | 備注 ---|--- | --- | --- adminUserName | String| N | 賬號 realName| String| N | 姓名 ##### 出參： 屬性名 | 類型| 備注 ---|--- | --- code | Integer | 狀態碼 msg | String | 消息 data | Object| name| String|部門名稱 departId| Long|部門id childList| List| 子部門 account| List| 該部門下的賬號列表 curr| List| 該部門下的微信號列表 ##### 出參示例： ``` { "code":200, "msg":"操作成功!", "data":[ ????????{ ????????????"name":"組織架構", ????????????"departId":0, ????????????"childList":[ ????????????????Object{...} ????????????], ????????????"account":[ ????????????????{ ????????????????????"adminUserId":11855, ????????????????????"realName":"hhhaaa", ????????????????????"adminUserName":"lixiaolin", ????????????????????"curr":[ ????????????????????????{ ????????????????????????????"wechatUserId":663, ????????????????????????????"uin":2368771701, ????????????????????????????"userName":"wxid\_15s48dvw9f7s22", ????????????????????????????"nickName":"小爭小吵小任性。", ????????????????????????????"headImgUrl":"http://wx.qlogo.cn/mmhead/ver_1/JRmibsM00VpaVK8BoDcSsdmxr5aiaZXaVicyKLRjICoFymNfoCeGC3YqfNzAV9lacAUeab4cFQFNQ0OyWaOpVpBvZ8XcgSKwSAZZbB66jxFs2U/0", ????????????????????????????"remarkName":null, ????????????????????????????"secName":"啊啊啊啊", ????????????????????????????"adminUserId":11855, ????????????????????????????"departId":0, ????????????????????????????"departName":null, ????????????????????????????"parentId":0, ????????????????????????????"realName":"hhhaaa", ????????????????????????????"adminUserName":"lixiaolin", ????????????????????????????"onLineStatus":1 ????????????????????????} ????????????????????] ????????????????} ????????????] ????????} ????] } ```