SuperAPI AI 工具集

dws-viewer-api

编程与开发

查看项目

更新于 10-16 04:53

技能介绍

用途:Nutrient DWS Viewer API 是 Nutrient 的云端文档查看服务,本技能覆盖其服务器端两步——上传文档到 Nutrient 托管存储(或引用应用自有文档),以及签发短期会话 JWT 交给浏览器,由 Nutrient Web SDK 渲染完整查看器。API 密钥绝不能进入浏览器,因此仍需一个可信后端或无服务器端点来签发会话令牌。

主要能力:DWS 托管模式下上传文档获得 document_id,再为其签发会话;应用提供模式下后端仅签发空体会话,文件由开发者在浏览器端自行流式传给 SDK。会话默认仅授予 read 权限,write 与 download 需显式开启;默认有效期 1 小时,可通过 --expires-in 延长至文档所述上限 24 小时。

使用方式:先获取 DWS Viewer API 专用密钥并导出为 NUTRIENT_DWS_VIEWER_API_KEY,然后在包含 SKILL.md 的目录运行 uv run scripts/viewer-session.py。常用命令包括 upload --file doc.pdf、session --document-id <id> --jwt-out session.jwt、upload-and-session --file doc.pdf --jwt-out session.jwt,以及 delete --document-id <id> 做清理。JWT 必须指定输出目标:--jwt-out 文件(0600 权限)或交互式 --print-jwt。

适用场景:希望在 SaaS 应用中嵌入 PDF 查看、评审、审批、批注、表单或签署流程,且不想自建服务器;需要开箱即用的批注持久化或实时多人协作。若需自托管 WASM 查看器或数据驻留、自定义认证,应改用 nutrient-web-sdk 或 nutrient-document-engine。

限制:上传文档会消耗配额(免费层每月 100 文档 / 500 MiB / 100 次上传),用完需删除;--app-provided 的授权范围未经验证且 TTL 不受 --expires-in 约束,不应作为默认;目前没有确认的会话吊销端点,泄露的 JWT 只能通过轮换 API 密钥并等待过期来收敛。密钥与 JWT 均不得写入提交文件或客户端源码。