SuperAPI AI 工具集

dropbox

办公与效率

查看项目

更新于 10-16 07:25

技能介绍

用途:该技能面向 Dropbox 云存储的 API 调用,当用户提及 Dropbox、dropbox.com、分享 Dropbox 链接、上传到 Dropbox 或询问云存储时触发,通过 curl 访问 Dropbox HTTP API 完成账户查询、文件与文件夹管理、上传下载、分享和文件请求等任务。

主要能力:账户方面可获取当前账户与空间用量;文件与文件夹方面支持列出文件夹(含分页 continue 与获取最新 cursor)、获取元数据、搜索文件、创建/删除/永久删除、移动、复制、查看与恢复历史版本、保存 URL 到 Dropbox、标签的获取/添加/移除;上传下载方面支持上传(单次最大 150 MB)、下载、获取临时下载链接(4 小时有效)、获取缩略图;分享方面支持创建、列出、修改、撤销共享链接,以及共享文件夹、添加/列出/移除成员、列出共享文件夹;文件请求方面支持列出、创建、获取、更新、删除与计数。

使用方式:所有请求几乎都用 POST,包括读取操作,不使用 GET。认证通过 Authorization: Bearer $DROPBOX_TOKEN 头传递。元数据操作使用 api.dropboxapi.com,文件内容(上传/下载/缩略图)使用 content.dropboxapi.com。路径以 / 开头表示绝对路径,list_folder 中用空字符串 "" 表示根目录,路径不区分大小写但保留大小写。分页时若 has_more 为 true,用返回的 cursor 调用 */continue 端点。上传模式有 add(已存在则失败)、overwrite、update(配合 rev)。共享链接应使用 create_shared_link_with_settings,而非已弃用的 create_shared_link。批量操作可用 copy_batch、move_batch、delete_batch。

适用场景:需要以编程方式管理 Dropbox 文件、批量整理或迁移文件、生成分享链接、收集他人上传的文件请求,以及把 URL 内容直接保存到 Dropbox 等。

限制:单次简单上传上限 150 MB,更大文件需使用上传会话(upload_session/start、append、finish);永久删除需要 Dropbox Business 且已启用该功能;遇到 429 响应需按 Retry-After 头退避重试。故障排查可运行 zero doctor check-connector --env-name DROPBOX_TOKEN 或 zero doctor check-connector --url https://api.dropboxapi.com/2/users/get_current_account --method POST。更多细节见官方 HTTP API 文档。