Skip to content
遇到问题?

操作中遇到困难,可以查阅常见问题或联系在线客服获取帮助。

查看常见问题

开放平台(集成 Token) ​

「开放平台」是机构后台「设置 → 高级设置」中的新标签页,用来创建集成 Token:把机构后台的能力接入第三方工具(如腾讯 WorkBuddy 的「魔果云课」连接器)。

前往「高级设置」后台

谁能看到:「开放平台」标签页仅机构拥有者(owner)账号登录后可见,老师、助教等其他成员账号不会显示该页签。

权限边界:Token 能访问什么,由创建时勾选的权限范围、以及创建它的那个账号自身的权限共同决定(取交集)——Token 不会越出创建账号的权限去拿数据。删除、退款、导出类接口不属于任何权限范围,Token 无法调用。

一、新建 Token ​

  1. 进入「设置 → 高级设置 → 开放平台」,点击「新建 Token」按钮。
  2. 在「新建集成 Token」弹窗中:
    • 名称:必填,最长 32 个字(输入框提示示例:「例如:WorkBuddy 连接器」),用来区分不同用途。未填写时提示「请填写名称」。
    • 权限范围:至少勾选一项(未勾选时提示「至少选择一项权限」)。带「可写」标记的权限项会修改机构数据,请谨慎授予。页面提示原文:「只勾选实际需要的权限。带「可写」的会修改机构数据,请谨慎授予。」
  3. 点击「创建」。

二、可选的权限范围 ​

权限项是否可写能做什么
查看课程与课时只读读取课程、单元、课时信息
创建/编辑课程、单元与课时可写新建、修改课程与课时结构
查看打卡活动与任务只读读取打卡活动与任务情况
创建/编辑打卡活动与任务可写新建、修改打卡活动与任务
查看学员名单与报名记录只读读取学员名单、报名记录
查看学习与授课统计只读读取学习、授课统计数据

三、保存 Token 明文(只显示一次) ​

创建成功后会弹出「Token 创建成功」窗口,其中显示 Token 的明文,并提示:

「请立即复制保存,关闭后将无法再次查看」 「出于安全考虑,系统只保存 Token 的摘要,不保存明文。丢失后只能吊销重建。」

  • 点击「复制」可一键复制(复制成功提示「已复制」;若浏览器限制剪贴板,会提示「复制失败,请手动选中复制」,请手动选中复制)。
  • 确认后点击「我已保存」关闭窗口。此窗口不能按 ESC 或点空白处关闭。
  • 关闭窗口后就再也看不到这串明文了。如果丢失,只能在列表里把它「吊销」,再新建一个。

四、查看与吊销 ​

列表展示每个 Token 的:名称、Token(只显示前缀+······,用于辨认是哪一个)、权限范围(可写项以醒目颜色标记)、最后使用(从未使用过显示「从未使用」)、状态、操作。

  • 状态有三种:「生效中」「已过期」「已吊销」。页面当前创建的 Token 不设置有效期,在吊销前一直有效。
  • 需要停用某个 Token 时(例如第三方工具不再使用、或怀疑明文泄露),点该行「操作」列的「吊销」,在确认框「吊销后使用该 Token 的第三方工具会立即失效,且无法恢复。确定吊销「名称」吗?」中点「确定吊销」。成功后提示「已吊销」,该 Token 立即失效且无法恢复。
  • 权限勾选创建后不能修改,需要调整请吊销后重建(页面顶部说明原文:「Token 的权限由创建时勾选的范围决定,创建后不能修改,需要调整请吊销后重建」)。
  • 还没有创建过任何 Token 时,列表显示「还没有创建过 Token」。

常见问题 ​

  • 成员账号看不到「开放平台」页签? 该功能仅向机构拥有者开放,请用拥有者账号登录。
  • 第三方工具拿着 Token 却看不到某些数据? 实际可用范围 = 权限范围 × 创建账号自身权限。若创建账号本身没有某些数据的权限,Token 也拿不到。
  • 创建或吊销失败? 按页面弹出的后端提示处理;无具体原因时分别提示「创建失败」「吊销失败」。

相关功能 ​

本文是否解决了您的问题?