使用GEWE框架进行微信群组管理(三)

友情链接:GEWE框架官网  geweapi.com  点击访问即可。

邀请或添加联系人进群

小提示:
  • 不管是添加40人以内还是以上都用此接口
  • cause填写邀请进群的理由
请求URL:
  • http://域名地址/api/group/invite
请求方式:
  • POST
请求头:
  • Content-Type:application/json

  • X-GEWE-TOKEN: 后台获取

参数:
参数名必填数据类型说明
appidstring设备id
group_idstring群id
causestring邀请进群的理由
to_wxidarray被邀请人wxid

返回数据:
参数名数据类型说明
retnumber0:成功
msgstring反馈信息
dataobject

请求参数示例:
   {
       "appid": "wxid_p3r6ddddvqcl22",
       "cause": "通过一下",
       "group_id": "34876481524@chatroom",
       "to_wxid": [
           "wxid_phyyedw9xap22"
       ]
   }

成功返回示例:
    {
        "ret": 0,
        "msg": "success",
        "data": {
            "baseResponse": {
                "ret": 0,
                "errMsg": {
                    "string": "Everything is OK"
                }
            },
            "MemberCount": 1,   #被邀请人数量
            "MemberList": [     #被邀请人详情
                {
                    "MemberName": {
                        "string": "wxid_4bxxxxxxxxxxx22"
                    },
                    "MemberStatus": 0,
                    "NickName": {   #昵称
                        "string": "xahya"
                    },
                    "PYInitial": {  
                        "string": "XAHYA"
                    },
                    "QuanPin": {
                        "string": "xahya"
                    },
                    "Sex": 1,   #性别
                    "Remark": {
                        "string": "xahya"   #群里的昵称
                    },
                    "RemarkPyinitial": {
                        "string": "XAHYA"
                    },
                    "RemarkQuanPin": {
                        "string": "xahya"
                    },
                    "ContactType": 0,
                    "Province": "Jiangsu",  #省份
                    "City": "Xuzhou",   #城市
                    "Signature": "123",     #个性签名
                    "PersonalCard": 1,  #个人名片
                    "VerifyFlag": 0,
                    "Country": "CN"
                }
            ]
        }
    }

错误返回示例:
    {
        "ret": 0,
        "msg": "success",
        "data": {
            "baseResponse": {
                "ret": -2,
                "errMsg": {
                    "string": "<e>\n<ShowType>1</ShowType>\n<Content><![CDATA[添加参与人失败]]></Content>\n<Url><![CDATA[]]></Url>\n<DispSec>30</DispSec>\n<Title><![CDATA[]]></Title>\n<Action>4</Action>\n<DelayConnSec>0</DelayConnSec>\n<Countdown>0</Countdown>\n<Ok><![CDATA[]]></Ok>\n<Cancel><![CDATA[]]></Cancel>\n<Icon>0</Icon>\n</e>\n"
                }
            },
            "MemberCount": 0
        }
    }

获取群组成员信息

小提示:
  • 支持企微群
  • 查询出来的信息可能存在偏差
请求URL:
  • http://域名地址/api/group/member
请求方式:
  • POST
请求头:
  • Content-Type:application/json

  • X-GEWE-TOKEN: 后台获取

参数:
参数名必填数据类型说明
appidstring设备id
group_idstring群id

返回数据:
参数名数据类型说明
retnumber0:成功
msgstring反馈信息
dataobject

请求参数示例:
   {
       "appid": "wxid_p3r6ddddvqcl22",
       "group_id": "34876481524@chatroom",
   }

成功返回示例:
    {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": 0,
                "errMsg": {}
            },
            "ChatroomUserName": "34876481524@chatroom",     #群wxid
            "ServerVersion": 700000008,
            "NewChatroomData": {    #群成员信息
                "MemberCount": 3,   #群成员人数
                "ChatRoomMember": [
                    {
                        "UserName": "wxid_vr2kwrzbg0q622",    #微信号
                        "NickName": "尤某人",   #昵称
                        "BigHeadImgUrl": "https://wx.qlppaz9QKlFfsjzQ/0",   #大号头像
                        "SmallHeadImgUrl": "https://wx.qlogo.cn/mzQ/132",   #小号头像
                        "ChatroomMemberFlag": 2049,
                        "InviterUserName": "wxid_p3r6ddddvqcl22" 邀请人wxid
                    },
                    {
                        "UserName": "wxid_p3r6ddddvqcl22",
                        "NickName": "Z💭",
                        "BigHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/pBuLcF8bHgbiaSQozgotYOSfgOBpgpD0WQPDTt7iaox7Cga7ibvfqYxnbpGoCkicicPRYEiaI3esA9ZJ8xiceMHZ1qNkhIYm9c3uI2JDiaeuZKXqGxQ/0",
                        "SmallHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/pBuLcF8bHgbiaSQozgotYOSfgOBpgpD0WQPDTt7iaox7Cga7ibvfqYxnbpGoCkicicPRYEiaI3esA9ZJ8xiceMHZ1qNkhIYm9c3uI2JDiaeuZKXqGxQ/132",
                        "ChatroomMemberFlag": 1
                    },
                    {
                        "UserName": "wxid_4bxxxxxxxxxxx22",
                        "NickName": "xahya",
                        "BigHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/GvJjOhWuoibaPk2wuib8UuFYPdRgdTFKXh1gUvVts5UrWGmmew8iccBGymJibm1ydlGBSZ3orWkrf56fbWAH3Ds5XN2t1dUG11DQQtEEGSqdvkM/0",
                        "SmallHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/GvJjOhWuoibaPk2wuib8UuFYPdRgdTFKXh1gUvVts5UrWGmmew8iccBGymJibm1ydlGBSZ3orWkrf56fbWAH3Ds5XN2t1dUG11DQQtEEGSqdvkM/132",
                        "ChatroomMemberFlag": 1,
                        "InviterUserName": "wxid_p3r6ddddvqcl22"
                    }
                ],
            }
        }
    }

错误返回示例:
    {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": -2,
                "errMsg": {
                    "string": ""
                }
            }
        }
    }

保存到通讯录

小提示:
  • 将群组保存到通讯录,方便下次能从通讯录中获取
请求URL:
  • http://域名地址/api/group/member
请求方式:
  • POST
请求头:
  • Content-Type:application/json

  • X-GEWE-TOKEN: 后台获取

参数:
参数名必填数据类型说明
appidstring设备id
group_idstring群id
valuenumber3添加 2移除

返回数据:
参数名数据类型说明
retnumber0:成功
msgstring反馈信息
dataobject

请求参数示例:
   {
       "appid": "wxid_p3r6ddddvqcl22",
       "group_id": "34876481524@chatroom",
        "value": 3,
   }

成功返回示例:
    {
        "ret": 0,
        "msg": "success",
        "data": {
            "ret": 0,
            "oplogRet": {
                "count": 1,
                "ret": "AA=="
            }
        }
    }

错误返回示例:
    {
        "ret": -1,
        "msg_err": "[{{appidw}}]设备不存在或已离线"
    }

一键添加群组联系人

小提示:
  • 注意不要频繁添加
  • 注意内容,避免风控
请求URL:
  • http://域名地址/api/group/oneclicktoaddgroupmembers
请求方式:
  • POST
请求头:
  • Content-Type:application/json

  • X-GEWE-TOKEN: 后台获取

参数:
参数名必填数据类型说明
appidstring设备id
contentstring添加好友验证信息
group_idstring群id
to_wxidstring群用户wxid

返回数据:
参数名数据类型说明
retnumber0:成功
msgstring反馈信息
dataobject
data.v1string好友凭证

请求参数示例:
   {
       "appid": "wxid_p3r6ddddvqcl22",
       "content": "jj",
       "group_id": "34876481524@chatroom",
       "to_wxid": "wxid_4bxxxxxxxxxxx22"
   }

成功返回示例:
  {
    "ret": 0,
    "msg": "success",
    "data": {
        "BaseResponse": {
            "ret": 0,
            "errMsg": {}
        },
        "v1": "v3_020b3826fd030100000000004f7920779e51ed000000501ea9a3dba12f95f6b60a0536a1adb6ab682894369b025a10e371ac2d27b824de65d74f5c0cf2708093d87013902b40a661568c0d2e0043e9308ffd3ab9ab63caa45065152775b510e30df23d@stranger"
    }
  }

错误返回示例:
    {
    "ret": -1,
    "msg": "fail",
    "msg_err": "无法正常获取[Ticket]请检查要添加的群组成员是否已存在好友关系",
    "data": null
}

查询群成员信息

小提示:
  • 返回的信息和查询联系人信息基本一致
  • 每次查询不得超过20位群成员
请求URL:
  • http://域名地址/api/group/querymembers
请求方式:
  • POST
请求头:
  • Content-Type:application/json

  • X-GEWE-TOKEN: 后台获取

参数:
参数名必填数据类型说明
appidstring设备id
contentstring添加好友验证信息
group_idstring群id
to_wxid_listarray群成员的wxid

返回数据:
参数名数据类型说明
retnumber0:成功
msgstring反馈信息
dataobject

请求参数示例:
   {
       "appid": "wxid_p3r6ddddvqcl22",
       "group_id": "34876481524@chatroom",
       "to_wxid_list": [
           "wxid_4bxxxxxxxxxxx22"
       ]
   }

成功返回示例:
    {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": 0,
                "errMsg": {}
            },
            "ContactCount": 1,  #群成员数量
            "ContactList": [    #群成员信息列表
                {
                    "UserName": {   #群成员wxid
                        "string": "wxid_4bxxxxxxxxxxx22"
                    },
                    "NickName": {   #群成员昵称
                        "string": "xahya"
                    },
                    "Pyinitial": {  #群成员昵称拼音大写
                        "string": "XAHYA"
                    },
                    "QuanPin": {      #群成员昵称全拼
                        "string": "xahya"
                    },
                    "Sex": 1,   #性别
                    "ImgBuf": {
                        "iLen": 0
                    },
                    "Remark": {},   群里的昵称
                    "ContactType": 0,
                    "Province": "Jiangsu",  #省份
                    "City": "Xuzhou",   #城市
                    "Signature": "123", #个性签名
                    "Alias": "_xahya",  #微信号
                    "BigHeadImgUrl": "https://fA0rWibpibG2WNjPrOTE/0",  #大号头像
                    "SmallHeadImgUrl": "https://wx.qlogNTE/132",    #小号头像
                    "NewChatroomData": {
                        "MemberCount": 1,
                        "ChatRoomMember": [
                            {
                                "UserName": "wxid_4bxxxxxxxxxxx22",
                                "ChatroomMemberFlag": 0,
                                "InviterUserName": "wxid_p3r6ddddvqcl22"  #邀请人wxid
                            }
                        ],
                    },
                    "ChatroomStatus": 0,
                    "textStatusFlag": 2,
                }
            ],
            "Ret": [
                0
            ],
            "Ticket": [
                {}
            ]
        }
    }

错误返回示例:
    {
        "ret": -1,
        "msg_err": "[{{appidd}}]设备不存在或已离线"
    }

设置群组公告

小提示:
  • 默认会@群组全员
  • 注意内容,避免风控
请求URL:
  • http://域名地址/api/group/setannouncement
请求方式:
  • POST
请求头:
  • Content-Type:application/json

  • X-GEWE-TOKEN: 后台获取

参数:
参数名必填数据类型说明
appidstring设备id
contentstring添加好友验证信息
group_idstring群id

返回数据:
参数名数据类型说明
retnumber0:成功
msgstring反馈信息
dataobject

请求参数示例:
   {
       "appid": "wxid_p3r6ddddvqcl22",
       "content": "设置群公告",
       "group_id": "34876481524@chatroom",
   }

成功返回示例:
    {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": 0,
                "errMsg": {}
            }
        }
    }

错误返回示例:
    {
        "ret": -1,
        "msg_err": "[{{appidd}}]设备不存在或已离线"
    }

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

iPad协议个微协议

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值