第38章 File URI 规范解析
第38章 File URI
File URI Cloudreve 使用 File URI 来定位、操作文件,或描述文件搜索条件。
结构 Cloudreve 使用的 File URI 符合传统 URL 标准。将 File URI 解析为标准 URL 时,会得到以下组成部分: 该 URI 的含义是:使用密码 2rje2bdj 访问共享 ID 为 VoMFL 的共享链接,并列出所有文件名包含 my file 的文件夹/子目录下的文件。
协议 固定为 cloudreve。
Host - 文件系统类型 定义文件所在文件系统的类型。 my: 我的文件;默认指向当前认证用户的文件。你也可以填入其他用户的 ID 以访问他们的文件,例如 cloudreve://luPa@my。只有管理员可以通过 my 访问其他用户的文件。 shared_with_me: 与我共享; trash: 回收站;
User - 文件系统 ID Cloudreve 使用 User 部分指定文件系统 ID。 对于 my 文件系统,User 为用户 ID;若留空,则默认为当前认证用户的 ID。 对于 shared_with_me 文件系统,User 不能为空,且应为共享链接 ID。
Password - 文件系统密码 目前仅共享文件系统使用 Password 部分。当共享链接非公开时,需通过 Password 部分指定访问密码。Cloudreve 会生成密码,并直接将其包含在创建者获得的共享链接中。
Path - 文件路径 文件路径,用于指定文件在文件系统中的位置。
Query - 搜索条件 文件搜索条件,用于指定文件搜索条件,仅适用于列出文件的 API。对于操作特定文件(删除、更新等)的 API,此部分将被忽略。可用的 Query 参数:
Query 参数 | 描述
name | 搜索文件名,可指定多个关键词,例如 name=mp3&name=op6。
name_op_or | 当 name 查询参数存在且包含多个关键词时,可指定 name_op_or=true,表示文件名包含任意一个关键词。
use_or | 与 name_op_or 相同。
case_folding | 当 name 查询参数存在时,可指定 case_folding=true,表示搜索忽略大小写。
category | 使用预设搜索条件查询文件类型,可用值为 image、video、audio、document。设置此查询后,其他查询条件将被忽略。
type | 可用值为 file 或 folder,用于过滤文件类型。
meta_