object

对象管理（上传、下载、删除、复制、移动）

📄️获取对象列表

获取对象列表

上传新对象到指定 Bucket。支持 multipart/form-data 和 binary body 两种上传方式。

覆盖已有对象，等同于 x-upsert: true 的创建。上传方式同创建对象。

删除对象

批量删除指定 Bucket 中的多个对象，单次最多 100 个。

以流式方式下载对象。可选携带 JWT：有 JWT 则按角色鉴权；无 JWT 且 bucket 为 public 时以 SuperUser 身份查询，非 public 则返回 404。

仅返回响应头。可选携带 JWT：有 JWT 则按角色鉴权；无 JWT 且 bucket 为 public 时以 SuperUser 身份查询，非 public 则返回 404。

复制对象

将对象从源位置移动到目标位置，源对象会被删除。

可选携带 JWT。有 JWT 则按角色鉴权，无 JWT 且 bucket 为 public 时以 SuperUser 身份查询。

生成签名下载 URL

获取多个对象生成预签名下载链接，单次最多 500 个。

使用预签名下载链接下载对象，不需要 Authorization。支持 GET（返回文件流）和 HEAD（仅返回响应头）。

与 GET 签名下载相同逻辑，但仅返回响应头（Content-Type、Content-Length、ETag 等），不返回文件内容。用于预检文件信息。

生成有时效的签名上传 URL，允许客户端无需直接认证即可上传文件。

通过预签名上传链接上传对象，不需要 Authorization（public 路由）。