跳至主要內容
說明中心

類別

搜尋說明中心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.

無論使用哪個權杖,您的帳戶本身都無權執行此操作。

#後續步驟

這篇文章有幫助嗎?