跳转到主要内容
POST
/
channel
/
whitelist_add
curl -X POST "http://localhost:5001/channel/whitelist_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/whitelist_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. 系统用户 > 白名单

​
使用场景

​
白名单与黑名单的关系

​
优先级规则

黑名单 > 白名单 > 普通权限

​
冲突处理

情况结果说明
同时在黑白名单按黑名单处理黑名单优先级更高
只在白名单享受白名单权限正常白名单用户
只在黑名单受黑名单限制正常黑名单用户
都不在名单普通用户权限按默认权限处理