文件 API
文件列表、元信息、目录、内容传输、版本、回收站与素材库接口。上传分为预上传和二进制传输两步,不要把预上传成功当成文件已经保存。删除、清空及覆盖操作前应确认权限和目标。
接口目录
| 方法 | 接口 | 路径 |
|---|---|---|
GET |
获取下载多文件地址 | /api/file/downloadMultiFiles.do |
GET |
获取下载文件缩略图地址 | /api/file/downloadThumbnail.do |
GET |
获取下载文件地址 | /api/file/getFileDownloadUrl.do |
GET |
预上传文件 | /api/file/preUploadFile.do |
GET |
文件日志 | /nd/api/file/file_logs |
GET |
获取文件信息 | /nd/api/file/fileinfo |
GET |
获取文件列表 | /nd/api/file/list_dir |
GET |
获取文件的所有版本信息 | /nd/api/file/versions |
POST |
拷贝文件进度 | /nd/api/file/copy_progress |
POST |
拷贝文件 | /nd/api/file/copy |
POST |
创建文件夹 | /nd/api/file/create_folder |
POST |
创建素材库分类 | /nd/api/file/create_material_class |
POST |
创建子素材库 | /nd/api/file/create_material_folder |
POST |
清空回收站 | /nd/api/file/empty_trash |
POST |
移动文件 | /nd/api/file/move |
POST |
删除文件(到回收站) | /nd/api/file/remove_file |
POST |
删除文件(从回收站) | /nd/api/file/remove_from_trash |
POST |
修改文件名 | /nd/api/file/rename |
POST |
恢复文件(从回收站) | /nd/api/file/restore_file |
POST |
设置用户是否有权访问素材库 | /nd/api/file/set_user_access_material_library |
POST |
修改文件信息 | /nd/api/file/update_file |
POST |
设置文件当前版本 | /nd/api/file/version |
完成上传
调用 预上传 取得一次性 url 和 upload_token,向该 URL 发起 multipart/form-data POST,包含二进制 file 与 upload_token。检查返回的 success、code、fileId 与 version。传输地址不能写死,过期或已使用后需要重新申请。
对接说明
本文依据《Babel 开发 API》整理,单接口页面保留原始路径和字段大小写。源文档未明确或存在类型冲突的字段需在联调中确认,不应假定存在未列出的参数。使用部署方提供的 HTTPS 域名;API 密钥与访问凭证不得写入公开页面。