Fankex

輸入關鍵字搜尋已發布文件。

mywebdrive

檔案與版本

在個人中心查看檔案列表、瀏覽版本、下載當前版本,以及了解尚未開放的檔案管理操作。

在個人中心找檔案

打開實例的 /account,在「我的檔案」區域可以看到你的檔案。每批請求 20 筆資料;點「載入更多」會使用伺服器回傳的 nextCursor 繼續取得,點「重新整理」則回到第一批重新載入。請留意,請求失敗的錯誤提示和「暫無檔案」是不同的狀態——不要把服務暫時無法回應當成檔案已經被清空了。

每筆檔案條目包含名稱、更新時間,以及當前版本的大小、版本號和 MIME 類型。如果 currentVersion: null,表示這個檔案還沒有可用版本,「版本」和「下載」按鈕會處於不可用狀態。這時候請等上傳完成後重新整理,而不是看到檔案名稱就認定內容已經保存好了。

查看版本

點檔案旁邊的「版本」,彈窗會列出版本號、大小和建立時間。這裡有三個概念需要區分:File 是邏輯檔案、File Version 是不可變的內容版本、Storage Object 是存儲層物件,三者的識別碼不能混用。

版本 API 支援游標分頁,每批預設 20 筆、最多 100 筆。目前彈窗只請求前 100 筆,沒有繼續翻頁的控制項;但這不表示超過 100 個版本就會消失——API 的 nextCursor 才決定是否還有後續資料。透過替換上傳可以增加版本,不過目前彈窗沒有「還原舊版」或「下載指定歷史版本」的按鈕。

下載當前版本

點「下載」後,客戶端會先用你的登入身份申請一張私有 Download Ticket,再用回傳的 downloadGrant 向 Storage 請求物件。票據有效期為 60 秒且只能消費一次,必須在點下載時即時申請,不能把物件位址當成永久公開的下載連結。

瀏覽器會將完整回應讀入 Blob 後才存檔,所以下載大檔案時可能佔用較多記憶體。原始碼沒有保證支援斷點續傳、多執行緒下載或任意 Range 請求。如果票據過期、已用完或下載中途斷開,重新點一次下載取得新票據即可;請不要自動無限重試同一張票據。

檔案列表 API 的邊界

GET /api/v1/files 預設每批 50 筆,最多 100 筆。省略 parentId 則不做父目錄過濾,parentId=null 則篩選根目錄。cursor 是一個綁定使用者、介面和篩選條件的簽名值,使用時請原樣傳遞;換了篩選條件就要從第一批重新開始,不能把不同帳戶的 cursor 拿來混用。

目前公開的檔案路由只提供查詢功能,沒有通用的建立資料夾、重新命名、移動、刪除或資源回收筒還原介面。資料模型裡雖然存在 folder 或 deletedAt 欄位,但不代表這些操作已經開放。請不要照著舊版網盤說明去找不存在的按鈕,也不要直接動資料庫來做日常檔案操作。

替換與同名衝突的細節請看上傳;空間相關的說明請看配額