跳转到主要内容
POST
/
channel
/
subscriber_add
curl -X POST "http://localhost:5001/channel/subscriber_add" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "group123",
    "channel_type": 2,
    "subscribers": ["user4", "user5", "user6"],
    "reset": 0,
    "temp_subscriber": 0
  }'

{
  "status": "ok"
}

​
概述

向频道添加订阅者（成员），支持批量添加和重置模式。

​
请求体

​
必传参数

​
channel_id
string
required
频道 ID
​
channel_type
integer
required
频道类型
  • 1 - 个人频道
  • 2 - 群组频道
​
subscribers
array
required
要添加的订阅者用户 ID 列表
​
subscribers[]
string
用户 ID

​
可选参数

​
reset
integer
default:0
是否重置现有订阅者
  • 0 - 不重置，追加新订阅者
  • 1 - 重置，替换所有现有订阅者
​
temp_subscriber
integer
default:0
是否为临时订阅者
  • 0 - 永久订阅者
  • 1 - 临时订阅者
curl -X POST "http://localhost:5001/channel/subscriber_add" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "group123",
    "channel_type": 2,
    "subscribers": ["user4", "user5", "user6"],
    "reset": 0,
    "temp_subscriber": 0
  }'

{
  "status": "ok"
}

​
响应字段

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

​
状态码

状态码说明
200订阅者添加成功
400请求参数错误
403没有操作权限
404频道不存在
500服务器内部错误

​
参数说明

​
重置模式 (reset)

值模式说明使用场景
0追加模式在现有成员基础上添加新成员邀请新成员加入
1重置模式清空现有成员，设置为新的成员列表重新组建群组

​
临时订阅者 (temp_subscriber)

值类型特点适用场景
0永久订阅者持久的成员关系正式群组成员
1临时订阅者临时的成员关系临时访客、会议参与者

​
使用场景

​
群组管理

  • 邀请新成员：群主或管理员邀请新用户加入群组
  • 批量导入：从其他平台批量导入成员列表
  • 重建群组：使用重置模式重新组建群组成员