跳转到主要内容
POST
/
channel
/
blacklist_add
curl -X POST "http://localhost:5001/channel/blacklist_add" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "group123",
    "channel_type": 2,
    "uids": ["user456", "user789"]
  }'

{
  "status": "ok"
}

​
概述

将用户添加到频道黑名单，被加入黑名单的用户将无法加入频道或发送消息。

​
请求体

​
channel_id
string
required
频道 ID
​
channel_type
integer
required
频道类型
  • 1 - 个人频道
  • 2 - 群组频道
​
uids
array
required
要添加到黑名单的用户 ID 列表
​
uids[]
string
用户 ID
curl -X POST "http://localhost:5001/channel/blacklist_add" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "group123",
    "channel_type": 2,
    "uids": ["user456", "user789"]
  }'

{
  "status": "ok"
}

​
响应字段

​
status
string
required
操作状态，成功时返回 "ok"

​
状态码

状态码说明
200黑名单操作成功
400请求参数错误
403没有管理权限
404频道不存在
500服务器内部错误

​
黑名单机制

​
限制范围

被加入黑名单的用户将受到以下限制：
操作限制效果说明
发送消息禁止发送无法在频道内发送任何消息

​
权限层级

黑名单的优先级高于其他权限设置：
  1. 黑名单 > 白名单 > 普通成员权限
  2. 管理员权限 > 黑名单（管理员不受黑名单限制）
  3. 系统用户 > 黑名单（系统用户不受黑名单限制）

​
使用场景

​
违规处理

  • 发送违规内容：对发送不当内容的用户进行限制
  • 恶意行为：处理恶意刷屏、骚扰等行为
  • 违反规则：对违反群组规则的用户进行惩罚