友情链接：geweapi.com 点击访问即可。
管理员操作
小提示：
- 添加、删除、转让
- 多个wxid时仅限于添加/删除管理员，1添加 2删除 3转让
请求URL：
请求方式：
- 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：
请求方式：
- 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：
请求方式：
- 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：
请求方式：
- 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]设备不存在或已离线"
}