# 场景1：Web/H5嵌入云文档界面
您可以在业务页面中嵌入云文档的文档库或编辑器。
集成方提供业务入口与业务侧逻辑，云文档提供文档界面和文档操作能力。
#### 整体交互流程
1. 集成方前端发起请求，向集成方后端请求获取文档访问凭证；
2. 集成方后端携带用户认证凭证，调用云文档服务接口申请一次性访问Ticket；
3. 云文档服务校验后，向集成方后端返回一次性Ticket；
4. 集成方后端将一次性Ticket返回给集成方前端；
5. 集成方前端携带获取到的Ticket，跳转/加载云文档页面；
6. 云文档页面发起请求到云文档服务，验证并消费该一次性Ticket；
7. 云文档服务校验通过，与云文档页面建立页面会话；
8. 云文档页面将页面就绪状态或失败结果返回给集成方前端，文档打开流程完成。
![](https://support.huaweicloud.com/devg-doczip/zh-cn_image_0000002789292345.png "点击放大")
#### 接入信息
表1接入信息 
| 项目     | 说明                                                                           |
|:---|:---|
| 页面地址   | 文档库或编辑器的正式访问地址，见[表2 页面地址说明] |
| 目标资源   | 本次打开的文档库或文档                                                                  |
| 页面接入凭证 | 后端为当前用户取得的一次性 Ticket                                                          |
| 页面交互   | 就绪、关闭、报错、会话失效等全量回调事件                                                          |
   
 表2页面地址说明 
| 地址说明 | URL                                      |
|:---|:---|
| 域名    | https://doczip.cn-north-4.huaweicloud.com/ |
| 云文档首页 | work-agent/#/cloud-docs                   |
| 指定云文档    | wapp/doc/{document_id}                      |
   
#### 会话与事件处理
1. Ticket 为一次性票据，一旦消费不可复用；页面刷新、会话失效时，后端需要重新申请 Ticket；
2. 跨窗口消息通信：必须校验消息来源、窗口对象，只接收可信源消息；
3. 监听页面回调事件，处理就绪、关闭、报错、会话失效等业务逻辑。
 
