# 移除群成员
[异步回调] 移除群成员,群内踢人
请求方式:POST
请求地址:https://$basehost/gateway/qopen/RemoveGroupMember
body参数:
{
"robot_id": "机器人id",
"group_id": "群id",
"member_id_list": ["移除成员id"]
}
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| robot_id | string | 是 | 机器人id |
| group_id | string | 是 | 群id |
| member_id_list | array | 是 | 移除成员id列表 |
返回值:
{
"data": {
"serial_no": "",
"failed_member_id_list":["",""]
},
"errcode": 0,
"errmsg": "",
"hint": ""
}
返回说明
| 字段 | 类型 | 说明 |
|---|---|---|
| errcode | int | 状态码,0为正常,非0代表错误 |
| errmsg | string | 错误信息 |
| data | json | json返回值 |
| serial_no | string | 操作序列号 |
| failed_member_id_list | array | 失败列表id |
| hint | string | 请求日志ID |
处理结果,异步返回值 encoding_content解密后的结构:
{
"event_type": 40009,
"serial_no": "cgxxxxxx",
"err_code": 0,
"err_msg": "success",
"data":{
"removed_member_id_list": ["xxxx","xxxx"],
"robot_id": "机器人id",
"group_id": "群id",
"group_name": "群名称"
}
}
说明
| 字段 | 类型 | 说明 |
|---|---|---|
| event_type | int | 事件类型,40009 |
| serial_no | string | 操作序列号 |
| err_code | int | 状态码,0为正常,非0代表错误 |
| err_msg | string | 错误信息 |
| removed_member_id_list | array | 移除成功列表 |
| robot_id | string | 机器人id |
| group_id | string | 群id |
| group_name | string | 群名称 |
完整请求示例:
curl -X POST \
https://$basehost/gateway/qopen/RemoveGroupMember \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{
"robot_id": "机器人id",
"group_id": "群id",
"member_id_list": ["移除成员id"]
}'