友情链接: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]设备不存在或已离线"}