更新时间：2026-10-22 GMT+08:00
场景1：Web/H5嵌入云文档界面
您可以在业务页面中嵌入云文档的文档库或编辑器。
集成方提供业务入口与业务侧逻辑，云文档提供文档界面和文档操作能力。
整体交互流程
- 集成方前端发起请求，向集成方后端请求获取文档访问凭证；
- 集成方后端携带用户认证凭证，调用云文档服务接口申请一次性访问Ticket；
- 云文档服务校验后，向集成方后端返回一次性Ticket；
- 集成方后端将一次性Ticket返回给集成方前端；
- 集成方前端携带获取到的Ticket，跳转/加载云文档页面；
- 云文档页面发起请求到云文档服务，验证并消费该一次性Ticket；
- 云文档服务校验通过，与云文档页面建立页面会话；
- 云文档页面将页面就绪状态或失败结果返回给集成方前端，文档打开流程完成。
接入信息
| 项目 | 说明 |
|---|---|
| 页面地址 | 文档库或编辑器的正式访问地址，见表2 页面地址说明 |
| 目标资源 | 本次打开的文档库或文档 |
| 页面接入凭证 | 后端为当前用户取得的一次性 Ticket |
| 页面交互 | 就绪、关闭、报错、会话失效等全量回调事件 |
会话与事件处理
- Ticket 为一次性票据，一旦消费不可复用；页面刷新、会话失效时，后端需要重新申请 Ticket；
- 跨窗口消息通信：必须校验消息来源、窗口对象，只接收可信源消息；
- 监听页面回调事件，处理就绪、关闭、报错、会话失效等业务逻辑。
