外观
开放平台(集成 Token)
「开放平台」是机构后台「设置 → 高级设置」中的新标签页,用来创建集成 Token:把机构后台的能力接入第三方工具(如腾讯 WorkBuddy 的「魔果云课」连接器)。
前往「高级设置」后台谁能看到:「开放平台」标签页仅机构拥有者(owner)账号登录后可见,老师、助教等其他成员账号不会显示该页签。
权限边界:Token 能访问什么,由创建时勾选的权限范围、以及创建它的那个账号自身的权限共同决定(取交集)——Token 不会越出创建账号的权限去拿数据。删除、退款、导出类接口不属于任何权限范围,Token 无法调用。
一、新建 Token
- 进入「设置 → 高级设置 → 开放平台」,点击「新建 Token」按钮。
- 在「新建集成 Token」弹窗中:
- 名称:必填,最长 32 个字(输入框提示示例:「例如:WorkBuddy 连接器」),用来区分不同用途。未填写时提示「请填写名称」。
- 权限范围:至少勾选一项(未勾选时提示「至少选择一项权限」)。带「可写」标记的权限项会修改机构数据,请谨慎授予。页面提示原文:「只勾选实际需要的权限。带「可写」的会修改机构数据,请谨慎授予。」
- 点击「创建」。
二、可选的权限范围
| 权限项 | 是否可写 | 能做什么 |
|---|---|---|
| 查看课程与课时 | 只读 | 读取课程、单元、课时信息 |
| 创建/编辑课程、单元与课时 | 可写 | 新建、修改课程与课时结构 |
| 查看打卡活动与任务 | 只读 | 读取打卡活动与任务情况 |
| 创建/编辑打卡活动与任务 | 可写 | 新建、修改打卡活动与任务 |
| 查看学员名单与报名记录 | 只读 | 读取学员名单、报名记录 |
| 查看学习与授课统计 | 只读 | 读取学习、授课统计数据 |
三、保存 Token 明文(只显示一次)
创建成功后会弹出「Token 创建成功」窗口,其中显示 Token 的明文,并提示:
「请立即复制保存,关闭后将无法再次查看」 「出于安全考虑,系统只保存 Token 的摘要,不保存明文。丢失后只能吊销重建。」
- 点击「复制」可一键复制(复制成功提示「已复制」;若浏览器限制剪贴板,会提示「复制失败,请手动选中复制」,请手动选中复制)。
- 确认后点击「我已保存」关闭窗口。此窗口不能按 ESC 或点空白处关闭。
- 关闭窗口后就再也看不到这串明文了。如果丢失,只能在列表里把它「吊销」,再新建一个。
四、查看与吊销
列表展示每个 Token 的:名称、Token(只显示前缀+······,用于辨认是哪一个)、权限范围(可写项以醒目颜色标记)、最后使用(从未使用过显示「从未使用」)、状态、操作。
- 状态有三种:「生效中」「已过期」「已吊销」。页面当前创建的 Token 不设置有效期,在吊销前一直有效。
- 需要停用某个 Token 时(例如第三方工具不再使用、或怀疑明文泄露),点该行「操作」列的「吊销」,在确认框「吊销后使用该 Token 的第三方工具会立即失效,且无法恢复。确定吊销「名称」吗?」中点「确定吊销」。成功后提示「已吊销」,该 Token 立即失效且无法恢复。
- 权限勾选创建后不能修改,需要调整请吊销后重建(页面顶部说明原文:「Token 的权限由创建时勾选的范围决定,创建后不能修改,需要调整请吊销后重建」)。
- 还没有创建过任何 Token 时,列表显示「还没有创建过 Token」。
常见问题
- 成员账号看不到「开放平台」页签? 该功能仅向机构拥有者开放,请用拥有者账号登录。
- 第三方工具拿着 Token 却看不到某些数据? 实际可用范围 = 权限范围 × 创建账号自身权限。若创建账号本身没有某些数据的权限,Token 也拿不到。
- 创建或吊销失败? 按页面弹出的后端提示处理;无具体原因时分别提示「创建失败」「吊销失败」。