创建 API 令牌
为 rclone 等脚本和工具创建个人 API 令牌,设置它可以访问的内容,并在不再需要时将其撤销。
API 令牌可让脚本或工具(例如 rclone)无需您的密码即可访问您的 Drime 账户。您可以为每个令牌设置权限,并可随时将其撤销。
个人令牌适用于您自己的脚本、备份和工具,作用于您自己的账户。如果您开发的应用需要由其他 Drime 用户连接到他们自己的账户,则应改用 OAuth,并且绝不能索要他们的密码:请参阅 Drime API 文档。
#创建令牌
点击右上角的头像,然后点击设置。
点击开发人员。
在 API 访问令牌中,点击创建令牌。

在令牌名称中,为令牌取一个您能认出的名称。
可以用使用该令牌的工具或电脑来命名,例如“NAS 上的 rclone”。名称长度必须为 3 到 100 个字符。
在权限下,选择令牌可以执行的操作。
全部:对所有资源的完整访问权限。
只读:对所有资源的只读访问权限。
受限:仅可访问您选择的资源,每项资源可设为无访问权、已读或写入。
请参阅选择合适的权限。

点击创建。
点击复制以复制令牌,然后点击完成。
令牌复制到剪贴板后,按钮会显示已复制!

令牌随后会出现在 API 访问令牌中,并立即生效。令牌不会过期:在您将其删除之前会一直有效。
#选择合适的权限
只授予令牌所需的权限。
权限 | 令牌可以执行的操作 |
|---|---|
全部 | 通过 API 执行您的账户可以执行的所有操作。 |
只读 | 读取下列所有资源,但不能做任何更改。 |
受限 | 仅限您设为已读或写入的资源。保留为无访问权的资源一律拒绝访问。 |
受限令牌会列出以下资源:文件(包括版本和垃圾桶)、文件夹、分享、工作区、Vault、签署、白板、文件要求、发送与追踪、联系人、标签和分析。分析(存储空间用量)只能读取,因此其选项为无访问权和访问。将鼠标悬停在资源旁的帮助图标上,即可查看该资源涵盖的内容。
只有全部令牌可以访问您的账户、安全和账单设置。只读和受限令牌始终无法访问这些设置。
令牌创建后,其权限无法更改。如需更改,请创建一个权限正确的新令牌,更新您的工具,然后删除旧令牌。
#使用令牌
在每个请求的 Authorization 请求头中发送令牌:
Authorization: Bearer YOUR_ACCESS_TOKENAPI 访问令牌旁边的说明文档链接会打开 Drime API 文档。如需在 rclone 中使用令牌,请参阅 Rclone、Drime CLI 和 WebDAV。
#查看和删除令牌
API 访问令牌会列出您创建的令牌,以及 Drime 各应用为自身创建的令牌:Drime Desktop、Drime 手机应用和浏览器扩展程序。每一行显示:
令牌名称,或应用及其平台,例如电脑版应用程序 · Windows;
令牌的权限,例如完整访问权;
上次使用的时间,或从未使用。
如果您还没有任何令牌,该部分会显示您还没有任何个人访问令牌。
撤销令牌的方法:
点击该令牌所在行末尾的删除令牌(垃圾桶图标)。

点击删除进行确认。
对话框会提示:此令牌将立即且永久删除。一旦删除,将无法再用于发出 API 请求。
随后会显示已删除令牌,所有使用该令牌的工具都会立即停止工作。
您也可以在查看您的会话和设备并退出登录中让 Drime 各应用退出登录。
#遇到问题时
您看到的情况 | 处理方法 |
|---|---|
开发人员中没有 API 访问令牌 | 您的账户未开通 API 访问。请联系 Drime 客服。 |
您丢失了令牌 | 令牌无法再次显示。请删除该令牌,然后创建一个新令牌。 |
点击创建后,令牌名称下方显示错误 | 名称长度必须为 3 到 100 个字符。 |
| 令牌缺失、有误或已被删除。请检查 |
| 该令牌为只读或受限,且缺少该资源的权限。请创建一个将该资源设为已读或写入的令牌(错误信息中会注明是哪项资源),或创建全部令牌。 |
| API 的这一部分(例如账户或账单设置)需要全部令牌。 |
| 无论使用哪个令牌,您的账户本身都无权执行此操作。 |
#后续步骤
这篇文章对您有帮助吗?