跳到主要内容
帮助中心

分类

搜索帮助中心Ctrl K
本页内容

创建 API 令牌

为 rclone 等脚本和工具创建个人 API 令牌,设置它可以访问的内容,并在不再需要时将其撤销。

更新于 Web

API 令牌可让脚本或工具(例如 rclone)无需您的密码即可访问您的 Drime 账户。您可以为每个令牌设置权限,并可随时将其撤销。

个人令牌适用于您自己的脚本、备份和工具,作用于您自己的账户。如果您开发的应用需要由其他 Drime 用户连接到他们自己的账户,则应改用 OAuth,并且绝不能索要他们的密码:请参阅 Drime API 文档。

#创建令牌

  1. 点击右上角的头像,然后点击设置。

  2. 点击开发人员。

  3. 在 API 访问令牌中,点击创建令牌。

    “设置”中的“开发人员”页面,显示“API 访问令牌”部分和“创建令牌”按钮
  4. 在令牌名称中,为令牌取一个您能认出的名称。

    可以用使用该令牌的工具或电脑来命名,例如“NAS 上的 rclone”。名称长度必须为 3 到 100 个字符。

  5. 在权限下,选择令牌可以执行的操作。

    • 全部:对所有资源的完整访问权限。

    • 只读:对所有资源的只读访问权限。

    • 受限:仅可访问您选择的资源,每项资源可设为无访问权、已读或写入。

    请参阅选择合适的权限。

    “创建新令牌”对话框,已填写令牌名称,并显示“权限”下的各个标签页
  6. 点击创建。

  7. 点击复制以复制令牌,然后点击完成。

    令牌复制到剪贴板后,按钮会显示已复制!

    新令牌仅显示这一次,旁边有“复制”按钮,以及提醒您将令牌存放在安全地方的警告

令牌随后会出现在 API 访问令牌中,并立即生效。令牌不会过期:在您将其删除之前会一直有效。

#选择合适的权限

只授予令牌所需的权限。

权限

令牌可以执行的操作

全部

通过 API 执行您的账户可以执行的所有操作。

只读

读取下列所有资源,但不能做任何更改。

受限

仅限您设为已读或写入的资源。保留为无访问权的资源一律拒绝访问。

受限令牌会列出以下资源:文件(包括版本和垃圾桶)、文件夹、分享、工作区、Vault、签署、白板、文件要求、发送与追踪、联系人、标签和分析。分析(存储空间用量)只能读取,因此其选项为无访问权和访问。将鼠标悬停在资源旁的帮助图标上,即可查看该资源涵盖的内容。

只有全部令牌可以访问您的账户、安全和账单设置。只读和受限令牌始终无法访问这些设置。

令牌创建后,其权限无法更改。如需更改,请创建一个权限正确的新令牌,更新您的工具,然后删除旧令牌。

#使用令牌

在每个请求的 Authorization 请求头中发送令牌:

Authorization: Bearer YOUR_ACCESS_TOKEN

API 访问令牌旁边的说明文档链接会打开 Drime API 文档。如需在 rclone 中使用令牌,请参阅 Rclone、Drime CLI 和 WebDAV。

#查看和删除令牌

API 访问令牌会列出您创建的令牌,以及 Drime 各应用为自身创建的令牌:Drime Desktop、Drime 手机应用和浏览器扩展程序。每一行显示:

  • 令牌名称,或应用及其平台,例如电脑版应用程序 · Windows;

  • 令牌的权限,例如完整访问权;

  • 上次使用的时间,或从未使用。

如果您还没有任何令牌,该部分会显示您还没有任何个人访问令牌。

撤销令牌的方法:

  1. 点击该令牌所在行末尾的删除令牌(垃圾桶图标)。

    “删除令牌?”确认对话框
  2. 点击删除进行确认。

    对话框会提示:此令牌将立即且永久删除。一旦删除,将无法再用于发出 API 请求。

    随后会显示已删除令牌,所有使用该令牌的工具都会立即停止工作。

您也可以在查看您的会话和设备并退出登录中让 Drime 各应用退出登录。

#遇到问题时

您看到的情况

处理方法

开发人员中没有 API 访问令牌

您的账户未开通 API 访问。请联系 Drime 客服。

您丢失了令牌

令牌无法再次显示。请删除该令牌,然后创建一个新令牌。

点击创建后,令牌名称下方显示错误

名称长度必须为 3 到 100 个字符。

401,并显示 Unauthenticated.

令牌缺失、有误或已被删除。请检查 Authorization: Bearer 请求头,或创建一个新令牌。

403,并显示 This API key is missing the required scope: files.write(或其他资源)

该令牌为只读或受限,且缺少该资源的权限。请创建一个将该资源设为已读或写入的令牌(错误信息中会注明是哪项资源),或创建全部令牌。

403,并显示 This endpoint cannot be accessed with a restricted API key.

API 的这一部分(例如账户或账单设置)需要全部令牌。

403,并显示 This action is unauthorized.

无论使用哪个令牌,您的账户本身都无权执行此操作。

#后续步骤

这篇文章对您有帮助吗?