建立 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 的這個部分(例如帳戶或帳單設定)需要全部權杖。 |
| 無論使用哪個權杖,您的帳戶本身都無權執行此操作。 |
#後續步驟
這篇文章有幫助嗎?