# 创建 API 令牌

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

更新于：2026-10-19  
来源：https://drime.cloud/zh-cn/support/integrations-and-api/api-tokens

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

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

## 创建令牌

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

2. 点击**开发人员**。

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

   ![“设置”中的“开发人员”页面，显示“API 访问令牌”部分和“创建令牌”按钮](https://drime.cloud/media/01M5A9VZ3EXT7ZMZHRBK5B9MS0/7ada18a14def-web-settings-developers-tokens.png)

4. 在**令牌名称**中，为令牌取一个您能认出的名称。

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

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

   - **全部**：对所有资源的完整访问权限。
   - **只读**：对所有资源的只读访问权限。
   - **受限**：仅可访问您选择的资源，每项资源可设为**无访问权**、**已读**或**写入**。

   请参阅[选择合适的权限](#permissions)。

   ![“创建新令牌”对话框，已填写令牌名称，并显示“权限”下的各个标签页](https://drime.cloud/media/01M59T977CYEFV0EGJSEE6Y0F7/1767ae179cc0-web-settings-developers-token-dialog.png)

6. 点击**创建**。

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

   令牌复制到剪贴板后，按钮会显示**已复制！**

   ![新令牌仅显示这一次，旁边有“复制”按钮，以及提醒您将令牌存放在安全地方的警告](https://drime.cloud/media/01M5A9VVN2VHMPSB1CPTQWH2G4/45e6a99fae24-web-settings-developers-token-shown-once.png)

> **重要**
>
> 令牌仅显示一次：**请务必将令牌存放于安全的地方。此对话框关闭后，将无法再查看该令牌。**
>
> 请立即将其存入密码管理器或工具的配置中。如果丢失了令牌，请将其删除并创建一个新令牌。

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

## 选择合适的权限

只授予令牌所需的权限。

| 权限 | 令牌可以执行的操作 |
| --- | --- |
| **全部** | 通过 API 执行您的账户可以执行的所有操作。 |
| **只读** | 读取下列所有资源，但不能做任何更改。 |
| **受限** | 仅限您设为**已读**或**写入**的资源。保留为**无访问权**的资源一律拒绝访问。 |

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

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

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

## 使用令牌

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

```
Authorization: Bearer YOUR_ACCESS_TOKEN
```

**API 访问令牌**旁边的**说明文档**链接会打开 [Drime API 文档](https://docs.drime.cloud/authentication)。如需在 rclone 中使用令牌，请参阅 [Rclone、Drime CLI 和 WebDAV](https://drime.cloud/zh-cn/support/integrations-and-api/rclone-cli-and-webdav)。

## 查看和删除令牌

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

- 令牌名称，或应用及其平台，例如**电脑版应用程序 · Windows**；
- 令牌的权限，例如**完整访问权**；
- 上次使用的时间，或**从未使用**。

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

撤销令牌的方法：

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

   ![“删除令牌？”确认对话框](https://drime.cloud/media/01M5A9VQDKFSB11N67Y0PAC592/fe208ec6869e-web-settings-developers-delete-token.png)

2. 点击**删除**进行确认。

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

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

您也可以在[查看您的会话和设备并退出登录](https://drime.cloud/zh-cn/support/account-and-settings/sessions-and-devices)中让 Drime 各应用退出登录。

## 遇到问题时

| 您看到的情况 | 处理方法 |
| --- | --- |
| **开发人员**中没有 **API 访问令牌** | 您的账户未开通 API 访问。请[联系 Drime 客服](https://drime.cloud/zh-cn/support/getting-started/contact-drime-support)。 |
| 您丢失了令牌 | 令牌无法再次显示。请删除该令牌，然后创建一个新令牌。 |
| 点击**创建**后，**令牌名称**下方显示错误 | 名称长度必须为 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.` | 无论使用哪个令牌，您的账户本身都无权执行此操作。 |

## 后续步骤

- [Rclone、Drime CLI 和 WebDAV](https://drime.cloud/zh-cn/support/integrations-and-api/rclone-cli-and-webdav)
- [查看您的会话和设备并退出登录](https://drime.cloud/zh-cn/support/account-and-settings/sessions-and-devices)