作为管理员,我该如何管理 API 访问令牌?

您可以从用户设置 (User Settings) 管理 API 访问令牌。访问令牌通过 Canvas API 提供 Canvas 资源的访问权限。访问令牌可以为第三方应用程序自动生成,也可以手动创建。

访问令牌持有者可以使用 Canvas API 访问与您相同的 Canvas 资源。例如,第三方应用程序获得授权用来代表您访问 Canvas,包括您用来开启 Canvas 移动应用程序的设备。API 调用需要授权,并且是代表授权用户进行的。如需了解更多关于使用 Canvas API 的信息,请查看 Canvas API 文档

一旦您有了 Canvas 登录,您就可以创建其中任一访问令牌,用于测试您的开发项目。此令牌必须作为 URL 查询参数包含在对 Canvas 进行的任何 API 调用中。

Canvas 令牌与 Canvas 权限保持一致。如果您的 Canvas 帐户被删除,您的令牌将被撤销。如果您在 Canvas 中不再具有管理角色,您以前生成的令牌将根据您的新权限进行调整。

注意:

  • 具有伪装权限的用户不能代表其他用户删除令牌。
  • Canvas 管理员无法批量删除其机构用户的 API 访问令牌。

打开用户设置

打开用户设置

在全局导航,点击账户 (Account) 链接 [1],然后点击设置 (Settings) 链接 [2]。

查看访问令牌

具备访问令牌和用户生成的访问令牌的第三方应用程序列在验证的集成 (Approved Integrations) 分组内 [1]。

关于每个访问令牌,您可以查看名称 [2]、目的 [3]、失效日期 [4] 和最后使用日期 [5]。

添加访问令牌

添加访问令牌

要添加访问令牌,请点击添加新访问令牌 (Add New Access Token) 按钮。

添加令牌详情

添加令牌详情

目的 (Purpose) 栏中输入访问令牌的说明 [1]。您也可以点击日历 (Calendar) 图标选择失效日期 [2]。要生成不会失效的令牌,请把失效 (Expires) 栏留空。

要生成新访问令牌,请点击生成令牌 (Generate Token) 按钮 [3]。

查看访问令牌

查看访问令牌

查看令牌说明 [1]。要查看令牌的详情,请点击详情 (details) 链接 [2]。

查看令牌详情

查看令牌详情

访问令牌详情包含令牌,可用于代表您调用 API [1]。

要重新生成访问令牌,请点击重新生成令牌 (Regenerate Token) 按钮 [2]。

删除访问令牌

删除访问令牌

要删除访问令牌,请点击删除 (Delete) 图标。

确认删除

确认删除

要确认删除,请点击确认 (OK) 按钮。