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