频道所属用户列表接口

该文档对应 live-background-aggregate 的 ChannelViewerListController。
这是直播后台登录态接口，userId 由系统根据当前登录账号自动注入。
用户端接口前缀：/live-bg/v3/user/channel-viewer/list
教师端接口前缀：/live-bg/v3/teacher/channel-viewer/list

1. 分页查询频道所属用户列表

• 接口地址
  • GET /live-bg/v3/user/channel-viewer/list/list
  • GET /live-bg/v3/teacher/channel-viewer/list/list
• 请求参数

• 查询说明

  • 支持按分组ID、用户昵称、用户ID、手机号组合查询
  • 查询结果会关联用户体系，返回用户昵称、手机号和分组名称

• 响应 data 字段

contents 数组元素说明：

• 请求示例

GET /live-bg/v3/user/channel-viewer/list/list?channelId=123456&groupId=1&nickname=张三&pageNumber=1&pageSize=20

2. 导出频道所属用户列表

• 接口地址
  • GET /live-bg/v3/user/channel-viewer/list/export
  • GET /live-bg/v3/teacher/channel-viewer/list/export
• 请求参数

• 处理说明

  • 导出接口不分页
  • 返回值 data 为导出任务ID，可结合导出任务查询接口查看进度和下载结果

• 请求示例

GET /live-bg/v3/user/channel-viewer/list/export?channelId=123456&groupId=1

3. 新增频道所属用户

• 接口地址
  • POST /live-bg/v3/user/channel-viewer/list/save
  • POST /live-bg/v3/teacher/channel-viewer/list/save
• 请求体参数

• 处理说明

  • 已存在的观众不会重复新增
  • 如果传了 groupId，已存在的观众会被更新到该分组

• 请求示例

{
  "channelId": 123456,
  "groupId": 1,
  "viewerIds": [
    "viewer-a",
    "viewer-b"
  ]
}

4. 删除频道所属用户

• 接口地址
  • POST /live-bg/v3/user/channel-viewer/list/delete
  • POST /live-bg/v3/teacher/channel-viewer/list/delete
• 请求体参数

5. 批量转移频道所属用户到指定分组

• 接口地址
  • POST /live-bg/v3/user/channel-viewer/list/transfer
  • POST /live-bg/v3/teacher/channel-viewer/list/transfer
• 请求体参数

6. 导入频道所属用户

• 接口地址

  • POST /live-bg/v3/user/channel-viewer/list/import
  • POST /live-bg/v3/teacher/channel-viewer/list/import

• 请求方式

  • multipart/form-data

• 表单参数

• 导入模板说明

  • Excel 第 1 列表头为：用户手机号

• 响应 data 字段

• 请求示例

curl -X POST 'https://live.polyv.net/live-bg/v3/user/channel-viewer/list/import?channelId=123456&groupId=1' \
  -F 'file=@/tmp/viewer-import.xlsx'

通用响应说明