跳转到主要内容
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临时订阅者临时的成员关系临时访客、会议参与者

使用场景

群组管理

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