跳转到主要内容
POST
/
channel
curl -X POST "http://localhost:5001/channel" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "group123",
    "channel_type": 2,
    "large": 0,
    "ban": 0,
    "subscribers": ["user1", "user2", "user3"]
  }'
{
  "status": "ok"
}

概述

创建新的聊天频道,支持个人频道和群组频道的创建。

请求体

必传参数

channel_id
string
required
频道 ID,必须唯一
channel_type
integer
required
频道类型
  • 1 - 个人频道
  • 2 - 群组频道

可选参数

ban
integer
default:0
是否禁言
  • 0 - 允许发言
  • 1 - 全员禁言
disband
integer
default:0
是否解散频道
  • 1 - 解散频道(不可逆)
send_ban
integer
default:0
是否禁止发送消息 (0.不禁止 1.禁止),禁止后,频道内所有成员都不能发送消息,个人频道能收消息,但不能发消息
allow_stranger
integer
default:0
是否允许陌生人发送消息(0.不允许 1.允许)(此配置目前只支持个人频道) 个人频道:如果AllowStranger为1,则陌生人可以给当前用户发消息,比如:当前账号需要接受陌生人消息,channel_id为当前用户的uid
subscribers
array
订阅者列表
subscribers[]
string
订阅者用户 ID
curl -X POST "http://localhost:5001/channel" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "group123",
    "channel_type": 2,
    "large": 0,
    "ban": 0,
    "subscribers": ["user1", "user2", "user3"]
  }'
{
  "status": "ok"
}

响应字段

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

状态码

状态码说明
200频道创建成功
400请求参数错误
409频道 ID 已存在
500服务器内部错误

最佳实践

  1. 频道 ID 唯一性:确保频道 ID 在系统中唯一
  2. 成员管理:合理设置初始订阅者列表
  3. 权限控制:根据需要设置禁言状态