巴别鸟巴别鸟文档

文件 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

完成上传

调用 预上传 取得一次性 urlupload_token,向该 URL 发起 multipart/form-data POST,包含二进制 fileupload_token。检查返回的 successcodefileIdversion。传输地址不能写死,过期或已使用后需要重新申请。

对接说明

本文依据《Babel 开发 API》整理,单接口页面保留原始路径和字段大小写。源文档未明确或存在类型冲突的字段需在联调中确认,不应假定存在未列出的参数。使用部署方提供的 HTTPS 域名;API 密钥与访问凭证不得写入公开页面。

开发 API 概览 · MCP 快速入门

巴别鸟企业网盘文档内容会随产品版本、授权模块和部署配置更新;具体能力以实际部署与管理员配置为准。