文件预览 API 如何接入已有业务系统
了解从源文件地址到阅读链接的调用流程，区分任务受理、转换完成和浏览器展示。
先由业务系统决定谁可以阅读
用户点击附件时，业务后端先验证登录状态和文件权限，再调用 96DOC 创建预览。文件地址可以来自业务存储或对象存储签名链接。接口密钥应保留在后端，不写入公开网页。
创建与等待是两个阶段
POST /api/preview 接收 url、filename、mtime、pdf 等根字段，阅读规则放入 options。HTTP 202 表示任务已受理，不能当成转换完成；任务就绪后阅读页显示结果，失败时应展示可理解的错误提示。
将阅读入口交给前端
前端使用返回的 previewURL 或 htmlURL 打开阅读页，也可以在业务页面中嵌入。需要保护原始源地址时，后端只返回合适的签名 HTML 入口，不把整份接口响应或源文件地址一起发给浏览器。
接入后检查完整链路
用正常文档、失败地址和重复请求分别验证。确认外部访问地址正确，阅读页资源与接口同样使用 HTTPS。任务轮询需合理安排间隔，业务方还应处理权限拒绝、服务繁忙与转换失败。
建议的验收方法
一个可执行的接入验收用例是：登录业务系统，打开有权限的附件，检查创建接口返回的阅读地址，再以无权限账号尝试同一个业务入口。还要测试源文件签名已失效、服务正在转换和接口繁忙等情况。页面应给出重试或联系管理员的明确路径，而不是无期限显示加载动画。