API 令牌对接另一台设备的能力对比

两种对外通道，定位不同

一句话分工：Office、Infuse 这类软件本身不支持专用 API，给它们 WebDAV 最省事；双方都说同一种语言时（比如两台设备都跑着本软件），令牌能拿到的多得多。

典型用法：应用连家里的服务

NAS 上跑着核心服务，手机或电视应用想共享那台机器的全部网盘：

1. 在那台核心服务的设置里建一个 API 令牌
2. 应用里「添加云存储」选 CloudDrive 类型，填地址加令牌
3. 接入后，那台机器连的所有网盘对应用来说就是一个普通云存储：浏览、播放、复制、离线下载照常

应用侧的接入细节见手机应用自带核心的独立用法。

授权范围自己划

令牌不是万能钥匙。建的时候可以限定：

• 根目录：只让它看某个文件夹
• 有效期：到期自动失效
• 逐项权限：读、写、改、系统操作、云存储操作、账号操作，每大类下面逐条勾

给家人建个只读令牌、给自己建个全权限令牌、给临时需求建个限期令牌——三把不同的钥匙，互不影响。

能力透传的意义

走令牌接入的远端，缩略图地址、搜索请求、离线任务、文件哈希、容量数字原样传过来：瀑布流出图不用拉原文件，搜索交给云端，往远端复制仍可能命中秒传，挂载后系统里显示的剩余空间也是对的。WebDAV 通道没有这些概念，每一次复制都只能逐字节传。

直链与安全提示

• 直链默认关闭，要用在对应网盘设置里开「支持直链」，且两端都需有效会员
• 云盘直链可能包含用户 ID、访问令牌等敏感信息——不要公开分享，不要交给不可信的第三方，后果自担

更粗粒度但更通用的分享走 WebDAV 独立用户，见自带 WebDAV 服务分享给局域网。