# 建立 API 權杖

為 rclone 等指令碼和工具建立個人 API 權杖，選擇權杖可以存取的內容，並在不再需要時撤銷權杖。

更新於：2026-10-19  
來源：https://drime.cloud/zh-tw/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-tw/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-tw/support/account-and-settings/sessions-and-devices)中登出 Drime 應用程式。

## 遇到問題時

| 您看到的狀況 | 處理方式 |
| --- | --- |
| **開發人員**中沒有 **API 存取權杖** | 您的帳戶尚未啟用 API 存取權。請[聯絡 Drime 客服](https://drime.cloud/zh-tw/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-tw/support/integrations-and-api/rclone-cli-and-webdav)
- [查看並登出您的工作階段和裝置](https://drime.cloud/zh-tw/support/account-and-settings/sessions-and-devices)