跳转到主要内容
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. 权限控制：根据需要设置禁言状态