使用gewe框架进行微信群组管理（一）

友情链接：geweapi.com   点击访问即可。

管理员操作

小提示：

• 添加、删除、转让
• 多个wxid时仅限于添加/删除管理员，1添加 2删除 3转让

请求URL：

• http://域名地址/api/group/admin

请求方式：

• POST

请求头：

• Content-Type：application/json

• X-GEWE-TOKEN: 后台获取

参数：

参数名	必填	数据类型	说明
appid	是	string	设备id
group_id	是	string	群id
to_wxid_list	是	array	管理员wxid
value	是	number	1添加 2删除 3转让

返回数据：

参数名	数据类型	说明
ret	number	0：成功
msg	string	反馈信息
data	object

请求参数示例：

   {
       "appid": "wx_nScLwnZhfNmlQlL0npc71",
       "group_id": "34876481524@chatroom",
       "to_wxid_list": [
           "wxid_vr2kwrzbg0q622"
       ],
       "value": 1,
   }

成功返回示例：

    {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": 0,
                "errMsg": {
                    "string": ""
                }
            }
        }
    }

错误返回示例：

    {
        "ret": -1,
        "msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]设备不存在或已离线"
    }

邀请进群申请确认

小提示：

• 该接口只限管理员
• 注意参数

请求URL：

• http://域名地址/api/group/approveaddchatroommember

请求方式：

• POST

请求头：

• Content-Type：application/json

• X-GEWE-TOKEN: 后台获取

参数：

参数名	必填	数据类型	说明
appid	是	string	设备id
group_id	是	string	群id
inviterWxid	是	string	邀请人wxid
msgid	是	number	消息id
ticket	是	string	申请id（解析回调消息获取）
to_wxid_list	是	array	被邀请人wxid

返回数据：

参数名	数据类型	说明
ret	number	0：成功
msg	string	反馈信息
data	object

请求参数示例：

   {
       "appid": "wx_nScLwnZhfNmlQlL0npc71",
       "group_id": "34876481524@chatroom",
       "inviterWxid": "wxid_p3r6ddddvqcl22",
       "msgid": 1181540864,
       "ticket": "AQAAAAEAAADIt9/NvtLHpCv0deeWnhAd7ilM+5i9aNpli+BDt67wfJCMktyGHwFPI3vdJGtemWZc7xurQnuB94jarnrAyFZk8wwkuA==",
       "to_wxid_list": [
           "wxid_zchk2n3lkccl22"
       ],
   }

成功返回示例：

    {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": 0,
                "errMsg": {
                    "string": ""
                }
            }
        }
    }

错误返回示例：

    {
        "ret": -1,
        "msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]设备不存在或已离线"
    }

 

创建群组

小提示：

• 注意：现在创建群组只有10人内不需要邀请确认
• 最少要填写两个联系人

请求URL：

• http://域名地址/api/group/create

请求方式：

• POST

请求头：

• Content-Type：application/json

• X-GEWE-TOKEN: 后台获取

参数：

参数名	必填	数据类型	说明
appid	是	string	设备id
to_wxid_list	是	array	联系人wxid，至少填写两个

返回数据：

参数名	数据类型	说明
ret	number	0：成功
msg	string	反馈信息
data	object
data.ChatRoomName	number	群wxid
data.MemberCount	number	群成员数量
data.MemberList	number	群成员列表
data.MemberList.MemberName	string	群成员wxid
data.MemberList.NickName	string	群成员昵称
data.MemberList.Remark	string	群成员备注
data.MemberList.City	string	城市

请求参数示例：

   {
       "appid": "wx_nScLwnZhfNmlQlL0npc71",
       "to_wxid_list": [
           "wxid_vr2kwrzbg0q622",
           "wxid_4bxxxxxxxxxxx22"
       ]
   }

成功返回示例：

    {
    "ret": 0,
    "msg": "success",
    "data": {
        "MemberCount": 2,
        "MemberLis": [
            {
                "MemberName": {
                    "string": "wxid_vr2kwrzbg0q622"
                },
                "MemberStatus": 0,
                "NickName": {
                    "string": "尤某人"
                },
                "PYInitial": {
                    "string": "YMR"
                },
                "QuanPin": {
                    "string": "youmouren"
                },
                "Sex": 1,
                "Remark": {
                    "string": "尤敦帅"
                },
                "ContactType": 0,
                "Province": "Jiangsu",
                "City": "Xuzhou",
                "Signature": "伴火同进者，终有一天会遇见命定之死！",
                "PersonalCard": 1,
                "VerifyFlag": 0,
                "Country": "CN"
            },
            {
                "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"
            }
        ],
        "ChatRoomName": {
            "string": "34876481524@chatroom"
        },
        
    }
}

错误返回示例：

    {
        "ret": -1,
        "msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]设备不存在或已离线"
    }

删除群组成员

简要描述：

• 俗称踢人

请求URL：

• http://域名地址/api/group/delmember

请求方式：

• POST

请求头：

• Content-Type：application/json

• X-GEWE-TOKEN: 后台获取

参数：

参数名	必填	数据类型	说明
appid	是	string	设备id
group_id	是	string	群id
to_wxid_list	是	array	群成员wxid

返回数据：

参数名	数据类型	说明
ret	number	0：成功
msg	string	反馈信息
data	object
data.MemberCount	number	被删群成员数量
data.MemberList	number	被删群成员列表
data.MemberList.MemberName	number	被删群成员wxid

请求参数示例：

   {
       "appid": "wx_nScLwnZhfNmlQlL0npc71",
       "group_id": "34876481524@chatroom",
       "to_wxid_list": [
           "wxid_4bxxxxxxxxxxx22",
       ]
   }

成功返回示例：

    {
        "ret": 0,
        "msg": "success",
        "data": {
            "baseResponse": {
                "ret": 0,
                "errMsg": {}
            },
            "MemberCount": 1,
            "MemberList": [
                {
                    "MemberName": {
                        "string": "wxid_4bxxxxxxxxxxx22"
                    }
                }
            ]
        }
    }

错误返回示例：

    {
        "ret": -1,
        "msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]设备不存在或已离线"
    }