核心用法
Dropbox Business API 技能通过 Maton 托管网关提供企业级 Dropbox 团队管理功能。用户需先配置 MATON_API_KEY 环境变量，然后在 api.maton.ai 创建 OAuth 连接完成 Dropbox 授权。所有请求通过 https://api.maton.ai/dropbox-business/2/{endpoint} 代理，自动注入 OAuth Token。
该技能覆盖团队管理的完整场景：
- 团队信息：查询团队概况、许可证使用、功能开关、当前管理员身份
- 成员管理：列出/查询成员详情（支持 V2 版本获取角色信息）、添加/暂停/恢复/移除成员、设置管理员权限、管理次要邮箱
- 组管理：创建/更新/删除组、批量增减成员（注意 "Everyone at..." 系统组不可修改）
- 团队文件夹：创建、重命名、归档/激活、永久删除、同步设置调整
- 设备与会话：查看所有成员的 Web/桌面/移动设备会话，批量撤销设备访问
- 第三方应用：审计团队成员关联的 OAuth 应用并撤销授权
- 审计日志：按 18 个事件类别（成员、文件操作、登录、分享等）检索团队活动记录
- 成员文件访问：通过
Dropbox-API-Select-User头模拟成员身份操作文件、共享文件夹、文件请求
所有列表端点采用游标分页（cursor + has_more），请求体必须为 JSON（即使无参数也需传 null）。支持 Python、JavaScript 等多种语言的完整代码示例。
显著优点
1. 托管 OAuth 简化集成：无需自建 OAuth 流程，Maton 处理 Token 刷新和存储
2. 企业级功能全覆盖：从成员生命周期管理到合规审计，满足 IT 管理员日常运维需求
3. 精细化权限控制：默认只读，写入操作强制要求显式用户确认和资源标识符展示
4. 成员代理能力：通过 Select-User 头可安全访问成员个人文件，便于数据迁移和合规检查
5. 安全设计：高影响操作（成员移除 wipe_data、永久删除等）强制确认不可逆后果，优先推荐可逆操作（归档优于删除、暂停优于移除）
潜在缺点与局限性
1. 写入操作门槛高：所有修改需显式确认，批量自动化场景交互成本较高
2. 异步任务需轮询：组操作、成员移除等返回 async_job_id，需额外调用 job_status 端点确认完成
3. API 风格特殊：全 POST 语义（含读操作）、.tag 类型标记、特定 JSON 结构，增加学习成本
4. 依赖 Maton 平台：OAuth 连接和 API 网关可用性绑定第三方服务，存在供应商锁定风险
5. 未明确速率限制：文档未详述 Dropbox API 具体限流策略，高并发场景需自行测试
适合人群
- IT 管理员：需要批量管理 Dropbox Business 团队成员、审计设备与会话
- 安全合规团队：检索审计日志、监控异常登录和文件操作事件
- 数据迁移工程师：利用 Select-User 功能协助成员数据导出和账户整合
- SaaS 集成开发者：构建与 Dropbox Business 打通的企业内部工具
常规风险
- 权限扩散风险：OAuth 连接授予团队级管理员权限，需使用最小权限账户并定期审查授权
- 误操作不可逆：永久删除团队文件夹、wipe_data 移除成员等操作无回收站，确认流程虽存在但仍需人工仔细核对
- 成员隐私边界：Select-User 功能可访问成员个人文件，需确保符合企业隐私政策和当地法规（GDPR 等）
- Token 泄露：
MATON_API_KEY泄露将导致 Dropbox 团队管理权限被盗用，需妥善保管环境变量 - 依赖服务中断：Maton 网关或 OAuth 服务故障将完全阻断 API 访问能力