文件 API 提供文件的上传、查询、列出与删除操作。
上传 File
POST /files
以 multipart/form-data 方式提交文件。单个文件最大 10 MB。
请求示例
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 文件 ID,格式 file_<ULID> |
filename | string | 原始文件名 |
size | int | 文件大小(字节) |
status | string | checking / available / rejected / type_rejected |
created_at | string | 上传时间,ISO 8601 |
查询 File
GET /files/{file_id}
返回文件元数据。
列出 File
GET /files
分页列出工作空间下的文件。
删除 File
DELETE /files/{file_id}
硬删除,不可恢复。已挂载到会话的副本不受影响。