跳转到主要内容
POST
/
channel
/
info
curl -X POST "http://localhost:5001/channel/info" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "group123",
    "channel_type": 2,
    "large": 1,
    "ban": 0
  }'

{
  "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
curl -X POST "http://localhost:5001/channel/info" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "group123",
    "channel_type": 2,
    "large": 1,
    "ban": 0
  }'

{
  "status": "ok"
}

​
响应字段

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

​
状态码

状态码说明
200频道信息更新成功
400请求参数错误
404频道不存在
500服务器内部错误

​
参数详解

​
频道类型 (channel_type)

值类型说明特点
1个人频道一对一私聊只有两个成员，不支持群组功能
2群组频道多人群聊支持多成员、群管理等功能

​
禁言状态 (ban)

值说明影响范围管理权限
0允许发言所有成员可正常发送消息群主和管理员可修改
1全员禁言只有管理员可发送消息仅群主可修改