Appearance
删除群成员
从指定微信群聊中移除一个或多个群成员。
接口地址: POST /deleteChatRoomMember
前置条件
- 微信实例已登录,并已获得可用的
wId。 - 当前微信实例仍在目标群聊中,并具备移除成员权限。
- 已确认目标成员的微信 ID,多个成员用英文逗号分隔。
- 删除群成员会影响真实群聊关系,调用前应由业务系统完成权限校验。
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
wId | 是 | string | 登录实例标识 |
chatRoomId | 是 | string | 群 ID |
userList | 是 | string | 群成员微信 ID,多个用英文逗号分隔 |
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
code | string | 1000 成功,1001 失败 |
message | string | 反馈信息 |
data | null | 成功或失败时通常为空 |
请求示例
json
{
"wId": "349be9b5-8734-45ce-811d-4e10ca568c67",
"chatRoomId": "24187765053@chatroom",
"userList": "wxid_ew6i9qdxlinu12,wxid_nqo37ves8w5t22"
}成功响应
json
{
"message": "成功",
"code": "1000",
"data": null
}错误响应
json
{
"message": "失败",
"code": "1001",
"data": null
}使用建议
- 删除成员前建议在业务后台二次确认,避免误踢成员。
- 批量删除建议分批执行,并记录每个成员的处理结果。
- 调用后可通过 获取群成员 核对成员是否已移除。
