文件 URI
Cloudreve 使用 文件 URI 来定位、操作文件，或者描述文件搜索条件。
构成
Cloudreve 使用的 文件 URI 符合传统的 URL 标准。当对一个 文件 URI 视作标准 URL 进行解析时，会得到以下部分：
这一 URI 表示的意思是：使用密码 2rje2bdj 访问分享 ID 为 VoMFL 的分享链接，列出 folder/child 目录下所有文件名包含 my file 的文件。
Protocol 协议名
固定为 cloudreve。
Host 主机名 - 文件系统类型
定义了文件所在文件系统的类型。
my: 我的文件；默认为当前请求认证的用户的文件，也可在User中填入其他用户的 ID 来访问其他用户的文件，比如cloudreve://luPa@my，只有管理员可以通过my访问其他用户的文件。shared_with_me: 与我共享；trash: 回收站；
User 用户名 - 文件系统 ID
Cloudreve 使用 User 部分来指定文件系统 ID。
- 对于
my文件系统，User为用户 ID，留空时为当前请求认证的用户的 ID； - 对于
shared_with_me文件系统，User不能为空，为分享链接 ID；
Password 密码 - 文件系统密码
目前只有 share 文件系统使用 Password 部分。当分享链接为非公开时，需要通过 Password 部分来指定访问密码，Cloudreve 会生成密码，并直接包含在创建者得到的分享链接中。
Path 路径 - 文件路径
文件路径，用于指定文件在文件系统中的位置。
Query 查询参数 - 搜索条件
文件搜索条件，用于指定文件搜索条件，只适用于列取文件的 API。对于操作指定文件的 API（删除、更新 等），这一部分会被忽略。可用 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_<key> | 使用文件 Metadata 查询文件，<key> 为 Metadata 键，如：meta_music:album=Deluxe, 其中 Metadata 键完整匹配为 music:album，值包含 Deluxe（忽略大小写）。也可使用空的值 meta_<key>= 来查询所有存在给定 Metadata 键的文件。 |
size_gte | 文件大小下限，只有大于 0 时有效。 |
size_lte | 文件大小上限，只有大于 0 时有效。 |
created_gte | 文件创建时间下限，Unix 秒级时间戳。 |
created_lte | 文件创建时间上限，Unix 秒级时间戳。 |
updated_gte | 文件更新时间下限，Unix 秒级时间戳。 |
updated_lte | 文件更新时间上限，Unix 秒级时间戳。 |