友情鏈接? geweapi.com 點擊訪問即可。

?

獲取群組詳情

小提示：

• 該接口可以一次查詢20個群組
• 查詢出來的信息是不帶公告的

請求URL：

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

請求方式：

• POST

請求頭：

• Content-Type：application/json

• X-GEWE-TOKEN: 后臺獲取

參數：

參數名	必填	數據類型	說明
appid	是	string	設備id
group_id_list	是	array	群id

返回數據：

參數名	數據類型	說明
ret	number	0：成功
msg	string	反饋信息

請求參數示例：

   {"appid": "wx_nScLwnZhfNmlQlL0npc71","group_id_list": ["18890011481@chatroom",]}

成功返回示例：

    {"ret": 0,"msg": "success","data": {"ContactCount": 1,"ContactList": [{"UserName": {"string": "34876481524@chatroom"    #群id},"NickName": {},     #群名稱"Pyinitial": {},    #群名稱拼音縮寫"QuanPin": {},      #群名稱拼音全寫"ChatRoomNotify": 1,    #群通知"ChatRoomOwner": "wxid_p3r6ddddvqcl22",     #群主"SmallHeadImgUrl": "https://wx.qlogo.cn/mmcrhead/9M0PhLTmTIfS3uZuXib55mfHBkWMpuzOhFQzWpSaAb5GUvhtJeG2LETarGFSfgUHvicVrMj3w2eic9SAOvdgDhPC538ZFo1hNTc/0",    #群頭像"CustomizedInfo": {"BrandFlag": 0},"ChatroomMaxCount": 500,    #群成員最大人數"ChatroomAccessType": 0,"NewChatroomData": {    #群組詳情"MemberCount": 2,   #群成員人數"ChatRoomMember": [     #群成員詳情{"UserName": "wxid_vr2kwrzbg0q622",  #群成員wxid"NickName": "尤某人",   #群成員昵稱"ChatroomMemberFlag": 2049,"InviterUserName": "wxid_p3r6ddddvqcl22"    #邀請人wxid},{"UserName": "wxid_p3r6ddddvqcl22","NickName": "Z💭","ChatroomMemberFlag": 1}],},}],"Ret": [0],"Ticket": [{}]}}

錯誤返回示例：

    {"ret": -1,"msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]設備不存在或已離線"}

解散群組

小提示：

• 該接口需要管理員操作權限
• 非管理員權限無法操作

請求URL：

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

請求方式：

• POST

請求頭：

• Content-Type：application/json

• X-GEWE-TOKEN: 后臺獲取

參數：

參數名	必填	數據類型	說明
appid	是	string	設備id
group_id	是	string	群id

返回數據：

參數名	數據類型	說明
ret	number	0：成功
msg	string	反饋信息
data	object

請求參數示例：

   {"appid": "wx_nScLwnZhfNmlQlL0npc71","group_id": "34876481524@chatroom",}

成功返回示例：

   {"ret": 0,"msg": "success","data": {"baseResponse": {"ret": 0,"errMsg": {}}}}

錯誤返回示例：

    {"ret": -1,"msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]設備不存在或已離線"}

獲取群組二維碼

小提示：

• 獲取的群組二維碼可以讓其他聯系人掃碼進群
• 支持企業群組

請求URL：

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

請求方式：

• POST

請求頭：

• Content-Type：application/json

• X-GEWE-TOKEN: 后臺獲取

參數：

參數名	必填	數據類型	說明
appid	是	string	設備id
group_id	是	string	群id

返回數據：

參數名	數據類型	說明
ret	number	0：成功
msg	string	反饋信息
data	object
data.qrcode	buffer	群二維碼base64數據

請求參數示例：

   {"appid": "wxid_p3r6ddddvqcl22","group_id": "34876481524@chatroom",}

成功返回示例：

    {"ret": 0,"msg": "success","data": {"BaseResponse": {"ret": 0,"errMsg": {}},"qrcode": {"iLen": 4981,"buffer": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgMCAgK//2Q=="   },"revokeQrcodeWording": "該二維碼7天內(7月28日前)有效，重新進入將更新"}
}

錯誤返回示例：

    {"ret": -1,"msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]設備不存在或已離線"}

掃碼進群

小提示：

• 用于操作掃碼進群、掃描二維碼等操作。
• 請先閱讀文檔

請求URL：

• http://域名地址/api/other/scaninroom

請求方式：

• POST

請求頭：

• Content-Type：application/json

參數：

參數名稱	數據類型	必填	說明
appid	string	是	設備id
config	string	是	二維碼解析鏈接

返回數據：

參數名	數據類型	說明
ret	number	0：成功
msg	string	反饋信息
data	object

請求參數示例：

   {"appid": "wxid_p3r6ddddvqcl22","config": "https://weixin.qq.com/g/AwYAALBQzXiBqrkUA6GzjbE4W-rfdXIduhjyg_I-UGTvo-gazUDDbJU9hUGGstZQ",}

成功返回示例：

  {"ret": 0,"msg": "success","data": {"ret": 0,"oplogRet": {"count": 1,"ret": "AA=="}}}

錯誤返回示例：

  {"ret": -1,"msg": "fail","msg_err": "地址讀取失敗,請重新嘗試"}

同意進群組

小提示：

• 同意進入聯系人邀請的群組
• 注意不要頻繁進入群組,避免風控

請求URL：

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

請求方式：

• POST

請求頭：

• Content-Type：application/json

• X-GEWE-TOKEN: 后臺獲取

參數：

參數名	必填	數據類型	說明
appid	是	string	設備id
url	是	string	邀請進群鏈接（解析回調消息獲取）

返回數據：

參數名	數據類型	說明
ret	number	0：成功
msg	string	反饋信息
data	object

請求參數示例：

   {"appid": "wxid_p3r6ddddvqcl22","url": "https://support.weixin.qq.com/cgi-bin/mmsupport-bin/addchatroombyinvite?ticket=AenMdVYiWiXApTjH7nKGRQ%3D%3D",}

成功返回示例：

 {"ret": 0,"msg": "success","data": {"ret": 0,"oplogRet": {"count": 1,"ret": "AA=="}}
}

錯誤返回示例：

  {"ret": -1,"msg": "fail","msg_err": "Post \"http:\": http: no Host in request URL"}

獲取群組信息詳情

小提示：

• 不支持批量查詢
• 注意本接口查詢出來的信息帶公告內容

請求URL：

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

請求方式：

• POST

請求頭：

• Content-Type：application/json

• X-GEWE-TOKEN: 后臺獲取

參數：

參數名	必填	數據類型	說明
appid	是	string	設備id
group_id	是	string	群id

返回數據：

參數名	數據類型	說明
ret	number	0：成功
msg	string	反饋信息
data	object
data.Announcement	string	群公告內容
data.AnnouncementPublishTime	string	群公告發布時間
data.AnnouncementEditor	string	群主wxid

請求參數示例：

   {"appid": "wxid_p3r6ddddvqcl22","group_id": "34876481524@chatroom",}

成功返回示例：

    {"ret": 0,"msg": "success","data": {"BaseResponse": {"ret": 0,"errMsg": {}},"Announcement": "測試","ChatRoomInfoVersion": 13,"AnnouncementEditor": "wxid_p3r6ddddvqcl22","AnnouncementPublishTime": 1689909184,"ChatRoomStatus": -2146959356,"ChatRoomBusinessType": 0,"RoomTools": {"RoomToolsWxAppCount": 0}}}

錯誤返回示例：

    {"ret": -1,"msg": "fail","msg_err": "A8K地址讀取失敗,請重新嘗試"}