伯索开放平台
首页
API文档SDK文档伯索官网
首页
API文档SDK文档伯索官网
  1. Open API帮助文档
  • 产品介绍
    • SDK简介
    • SDK支持的业务场景
    • 产品特色
  • 产品功能
    • 实时课堂功能介绍
    • 微课功能介绍
    • 作业批改功能介绍
    • 上传课件功能介绍
    • SDK后台功能介绍
  • 接入指引
    • SDK对接标准流程说明
    • 关键概念
  • SDK接入文档
    • 历史课堂数据回调接入
    • 签名示例
    • 历史课堂转视频接入方式
    • 历史课堂/微课下载接口
    • query参数说明
    • 文档解析接口
    • SDK预解析服务接入说明
    • 「伯索云学堂」跳转接入指南
    • Web SDK
      • PlasoStyleUpime API说明
      • 云盘接入
      • 接入预解析能力 (Web端)
      • 直播SDK
        • 快速接入
      • 微课SDK
        • 快速接入
      • 批注SDK
        • 快速接入
    • Electron SDK
      • 快速接入
    • Android SDK
      • 直播SDK
        • 快速接入
      • 微课SDK
        • 快速接入
      • 批注SDK
        • 快速接入
    • iOS SDK
      • 直播SDK
        • 快速接入
      • 微课SDK
        • 快速接入
      • 批注SDK
        • 快速接入
    • 播放器SDK
      • Web播放器
  • 最佳实践
  • Open API帮助文档
    • Open API 主要功能
    • Open API集成常用场景
    • 数据字典
    • 接入须知
      • 调用流程
      • 在线调试
      • 通用错误码
    • 用户信息管理
      • 添加用户
      • 修改密码
      • 删除用户
      • 更新用户
      • 用户精确查询
      • 查询多个用户
      • 用户访问Token
      • 验证用户Token有效期
      • 批量添加用户
      • 恢复删除的用户
      • 设置学生属性(是否跟随/是否加联/分配课程顾问)
      • 学生随机分配课程顾问(V2)
    • 教材包管理
      • 查询机构教材包
      • 查询教材包内教材
      • 向学生分发教材包
    • 实时课堂管理
      • 创建实时课堂
      • 创建实时课堂(班)
      • 更新实时课堂
      • 更新实时课堂(班)
      • 删除实时课堂
      • 查询实时课堂列表
      • 更新实时课堂下听众用户
      • 获取实时课堂监控地址
      • 控制单个学员是否可以回看单次课
      • 获取单个课堂的回看地址
      • 删除单个历史课堂
      • 获取课堂考勤数据
      • 获取历史课堂信息
      • 获取历史课堂观看数据
      • 获取课堂互动信息
      • 获取课堂列表(新)
      • 获取实时课堂旁听链接
      • 获取极速直播推流地址
      • 获取课堂下板书图片
    • 班级管理
      • 创建班级
      • 更新班级
      • 删除班级
      • 查询班级列表
      • 向班级中添加学生
      • 从班级中移除学生
      • 更换学生所在班级
      • 老师列表中查询机构分校学科
      • 根据班级获取获取班级详情和人员信息
      • 批量绑定老师到班级
    • 学情数据
      • 获取学生课堂明细数据
      • 获取学生巩固明细数据
      • 获取学生测验明细数据
      • 获取学生辅导明细数据
      • 获取学生积分明细数据
      • 获取学生课程统计数据
      • 获取学生课程详情统计数据
    • 商城管理
      • 获取商品详情
      • 获取商品列表
      • 获取分校自定义商品栏目列表
      • 订单查询
      • 订单详情查询
    • 作业管理
      • 查询学生作业列表
      • 查询老师作业列表
    • 测验管理
      • 查询机构测评列表
      • 获取测评统计
      • 查询机构测验列表
      • 获取测验明细
    • 积分管理
      • 机构积分规则
      • 查下学生当前积分数
      • 查下机构每天的积分明细记录
    • 课程顾问
      • 新建课程顾问
      • 编辑课程顾问
      • 查询课程顾问
      • 停用/启用课程顾问
      • 更新课程顾问密码
  • 产品更新记录
    • Open API 更新日志
    • SDK 更新日志
  • 常见问题
    • PPT制作事项
    • 课件常见问题与解决方法
    • 网络相关问题
    • 声音相关问题
    • 网络测速
  • 推荐
    • 浏览器推荐
    • 常见软件推荐
    • 教育硬件推荐
  • 历史课堂视频
    POST
  • 查询历史课堂
    POST
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
      • 返回值
    • Schemas
首页
API文档SDK文档伯索官网
首页
API文档SDK文档伯索官网
  1. Open API帮助文档

数据字典

用户类型

名称数值
学生student
老师teacher
助教assistant
临时学生tmpStudent
管理员admin
课程顾问consultant

用户性别

名称数值
男0
女1
隐私2

用户年级

支持义务教育阶段的小学、初中和高中。如需自定义年级,请移至伯索客户端修改。

名称数值
小班10
中班20
大班30
一年级40
二年级50
三年级60
四年级70
五年级80
六年级90
七年级100
八年级110
九年级120
高一130
高二140
高三150

教师权限字段(powers)数据字典

powers 字段是一个位掩码(Bitmask),用于配置老师/助教的各项权限。可以通过按位或(|)运算组合多个权限。

1. 基础权限

界面显示名称权限标识数值位运算说明
允许下载巩固、教材、教备和资料中心的文件supportDownload41 << 2历史课堂、微课、音视频不能下载
允许老师创建实时课堂createLiveClass11 << 0创建实时直播课堂的基础权限

2. 视频课堂互动人数权限

标清模式

界面显示名称权限标识数值位运算说明
1V1classMode_1v1_1081 << 31对1 标清(普清)模式
1V6classMode_1v6_10641 << 61对6 标清(普清)模式
1V12classMode_1v12_101281 << 71对12 标清(普清)模式

双摄模式

界面显示名称权限标识数值位运算说明
1V1标清双摄dual_camera_1v1_10655361 << 16双摄像头 1对1 标清
1V1高清双摄dual_camera_1v1_201310721 << 17双摄像头 1对1 高清
1V1超清双摄dual_camera_1v1_302621441 << 18双摄像头 1对1 超清

高清模式

界面显示名称权限标识数值位运算说明
1V1高清classMode_1v1_20161 << 41对1 高清模式
1V1超清classMode_1v1_30321 << 51对1 超清模式

高清+ 流畅模式

界面显示名称权限标识数值位运算说明
1V1高清+classMode_1v1_20_FLOW10241 << 101对1 高清+ 流畅模式
1V1超清+classMode_1v1_30_FLOW20481 << 111对1 超清+ 流畅模式

3. 直播权限

界面显示名称权限标识数值位运算说明
创建极速直播createLive5121 << 9创建极速直播功能
创建站播smart_class2561 << 8创建智慧课堂/站播功能

4. 助教权限

界面显示名称权限标识数值位运算说明
允许老师以助教身份进入所在班级中的课堂/直播assistant40961 << 12启用助教功能
生效课堂/直播范围assistantScope81921 << 130=仅未结束的课堂,1=全部课堂

📌 重要说明:

  • 只有 assistant 权限(4096):助教只能查看未结束的课堂/直播
  • 同时有 assistant + assistantScope(12288):助教可以查看所有课堂/直播(包括已结束)

5. 其他权限

界面显示名称权限标识数值位运算说明
允许老师查看学生用户名信息hiddenStuLoginname (反向)163841 << 14⚠️ 逻辑反向:有此权限=隐藏学生用户名
允许老师邀请体验学生或分享直播链接inviteCode21 << 1生成邀请码/分享链接
允许老师使用AI批改enableAIPiGai5242881 << 19AI批改作业功能,需机构开启 enableAIService

⚠️ 特别注意:hiddenStuLoginname 的逻辑与界面相反!

  • 界面选中"允许查看" = 不设置此权限位(powers & 16384 == 0)
  • 界面不选"允许查看" = 设置此权限位(powers & 16384 != 0),隐藏学生用户名
修改于 2026-01-04 04:01:24
上一页
Open API集成常用场景
下一页
调用流程
Built with