# 设置群管理员(废弃)
[异步回调] 设置群管理员(废弃)
当机器人为群主时,可以调用此接口设置新增群内其他成员为管理员或移除群内管理员为普通群成员;
说明:
- 管理员必须是企业通讯录好友,且在群内,最多可设置3名管理员。
- 该接口执行的是覆盖操作,原有管理员均会被移除,传空则移除所有管理员
- 数据校验失败的管理员会在接口返回值中给出, 发起失败的管理员会在回调中给出
请求方式:POST
请求地址:https://$basehost/gateway/qopen/SetGroupChatAdmin
body参数:
{
"robot_id": "机器人id",
"group_id": "群id",
"admin_account_id_list": ["管理员id"]
}
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
robot_id | string | 是 | 机器人id |
group_id | string | 是 | 群id |
admin_account_id_list | array | 是 | 管理员id列表,最多三个 |
返回值:
{
"data": {
"serial_no": "xxxxxx",
"fail_info_list": [
{
"account_id": "xxx",
"desc": "非群成员"
},
{
"account_id": "xxx",
"desc": "客户不存在"
}
]
},
"errcode": 0,
"errmsg": "",
"hint": ""
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
errcode | int | 状态码,0为正常,非0代表错误 |
errmsg | string | 错误信息 |
data | json | json返回值 |
data.fail_info_list | array | 失败列表 |
data.fail_info_list.account_id | string | 失败的成员id |
data.fail_info_list.desc | string | 失败的原因 |
serial_no | string | 操作序列号 |
hint | string | 请求日志ID |
处理结果,异步返回值 encoding_content解密后的结构:
{
"event_type": 40016,
"serial_no": "操作序列号",
"err_code": 0,
"err_msg": "success",
"data": {
"robot_id": "机器人id",
"group_id": "群id",
"failed_account_id_list": ["设置失败的的成员列表"]
}
}
说明
字段 | 类型 | 说明 |
---|---|---|
event_type | int | 事件类型,40016 |
serial_no | string | 操作序列号 |
err_code | int | 状态码,0为正常,非0代表错误 |
err_msg | string | 错误信息 |
robot_id | string | 机器人id |
group_id | string | 群id |
failed_account_id_list | array | 设置失败的的成员列表 |
完整请求示例:
curl -X POST \
https://$basehost/gateway/qopen/SetGroupChatAdmin \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{
"robot_id": "机器人id",
"group_id": "群id",
"admin_account_id_list": ["管理员id"]
}'