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 是绑定用户、接口和筛选上下文的签名值,请原样传递;换了筛选条件就从第一批开始,不能拼接或在不同账户间共享。

目前公共文件路由只提供查询,不提供通用的创建文件夹、重命名、移动、删除或回收站恢复接口。数据模型里存在 folder 或 deletedAt 字段,并不等于这些操作已经开放。不要照着旧版网盘的说明去找不存在的按钮,也不要直接改数据库来做日常文件操作。

替换上传和同名冲突的处理见上传,空间含义见配额