file_manager

# 文件管理器 API ## 概述 文件管理器 API 支持在 protocols.io 工作区内进行文件操作，包括上传文件、组织文件夹、搜索内容以及管理文件生命周期。这对于将数据文件、图像、文档和其他资源附加到协议中非常有用。 ## 基础 URL 所有文件管理器端点均使用基础 URL：`https://protocols.io/api/v3` ## 搜索与浏览 ### 搜索工作区文件 在工作区内搜索文件和文件夹。 **端点：** `GET /workspaces/{workspace_id}/files/search` **路径参数：** - `workspace_id`: 工作区的唯一标识符 **查询参数：** - `query`: 搜索关键词（搜索文件名和元数据） - `type`: 按类型过滤 - `file`: 仅文件 - `folder`: 仅文件夹 - `all`: 文件和文件夹（默认） - `folder_id`: 限制搜索到特定文件夹 - `page_size`: 每页结果数 (默认：20，最大：100) - `page_id`: 分页页码 (从 0 开始) **响应包含：** - 文件/文件夹 ID 和名称 - 文件大小和类型 - 创建和修改日期 - 工作区中的文件路径 - 下载 URL（针对文件） **请求示例：** bash curl -H "Authorization: Bearer YOUR_TOKEN" "https://protocols.io/api/v3/workspaces/12345/files/search?query=microscopy&type=file" ### 列出文件夹内容 浏览特定文件夹内的文件和文件夹。 **端点：** `GET /workspaces/{workspace_id}/folders/{folder_id}` **路径参数：** - `workspace_id`: 工作区的唯一标识符 - `folder_id`: 文件夹的唯一标识符（使用 `root` 表示工作区根目录） **查询参数：** - `order_by`: 排序字段 (`name`, `size`, `created`, `modified`) - `order_dir`: 排序方向 (`asc`, `desc`) - `page_size`: 每页结果数 - `page_id`: 分页页码 **请求示例：** bash curl -H "Authorization: Bearer YOUR_TOKEN" "https://protocols.io/api/v3/workspaces/12345/folders/root?order_by=modified&order_dir=desc" ## 文件上传 ### 上传文件 将文件上传到工作区文件夹。 **端点：** `POST /workspaces/{workspace_id}/files/upload` **请求格式**：`multipart/form-data` **表单参数：** - `file` (必需)：要上传的文件 - `folder_id`: 目标文件夹 ID（省略或使用 `root` 表示工作区根目录） - `name`: 自定义文件名（可选，省略则使用原始文件名） - `description`: 文件描述 - `tags`: 以逗号分隔的标签 **请求示例：** bash curl -X POST