OfficeWeb365文档在线预览服务-

       提供Office文档在线预览及PDF文档在线预览 API服务 ，包括Microsoft Word文档在线预览、Excel表格在线预览、Pow erp oint演示文档在线预览，WPS文字处理、WPS表格、WPS演示及Adobe PDF文档在线预览。

       除了预览还提供：文件转PDF、转图片、提取文字、在线打印、预览定时过期、试读多少页、包含动画的同步预览、阅读进度记录、预览水印、合并预览等丰富多彩的功能。

一、产品特点

          1、快、高并发
          预览速度，唯快不破，普通文档解析速度在100ms以内。即点即现的预览速度，谁与争锋？

          2、原样呈现
          Microsoft Office、WPS及Adobe PDF文档原始完美呈现，不再变样。Word 文档中的格式和布局会保留下来，PowerPoint 演示文稿中的动画会正常点击播放。客户端软件中什么样，浏览器中就是什么样。

          3、调用方便
           服务器端及客户端均不需要任何部署。支持任何操作系统（Windows、Mac、Linux）及浏览器，所有浏览器全部支持，包括Chrome、IE、Firefox、Safari、Opera等，且不需要安装任何ActiveX控件。

          4、完美支持移动设备、关键更省流量
           针对移动设备专门做了优化，更小的流量更快的速度，Word文档在线预览2页、Excel在线预览1个工作表保留格式的情况下仅仅只有3KB，全球中文支持最好的手机端在线预览技术。可以在手机及平板电脑上浏览所有支持的文档，与PC上的样式一致。

          5、减少投入
          不用再费力的去试图自己做这项投入巨大却功能单一的事情了；不用去高价购买体验不好的插件了；不用自己另外架设预览服务器。     

          6、省心省力
           统一接口，简单参数，一个URL参数传递过来即可开始华丽的预览Office文件，减少程序的编写工作，省心省力，用更多的精力去专注您的业务吧。

二、API调用步骤

          1、   请求API地址（接口网关认证），获取文件预览地址。

          2、   预览地址发送给前端，前端嵌入页面使用。

三、华为接口网关认证

          本应用为“APP认证”使用。APP认证的方法有两种：简易认证和签名认证。

          1、使用AppCode简易认证

          参见：https://support.huaweicloud.com/usermanual-apig/apig-lgug-200227001.html

                    1）新建一个应用，若已创建则忽略。绑定市场上购买的API

                    2）绑定 API

                    3）点击应用名称，进入设置

                    4）添加 AppCode

                    5）在请求 API 的请求头中携带此 AppCode 即可通过验证。注意请求头的 name

                         为：X-Apig-AppCode

          2、使用 AppKey 和 AppSecret 签名认证。

          签名认证较复杂 ,请参见 ：https://support.huaweicloud.com/devg-apig/apig-dev-180907066.html

四、接口调用

          1、调用地址 
                    https://ow365.apistore.huaweicloud.com/v2/gateway/fileurl 
          2、调用方法：POST 
          3、Header 头传递参数 
                    本 API 不用，注意得携带华为 API 认证。简易认证携带：X-Apig-AppCode。 
                    签名认证携带：AppKey、AppSecret、X-Sdk-Date 以及签名。 
          4、Body 体传递 Json 数据

五、接口返回

        1、成功

              { 
                  "request_ok": true, 
                  "view_url": "https://view.chigua.ren/v2/api?view=Vrz06UoN1eJMs1GO8uV", 
                  "error_msg": null, 
                  "return_code": 4, 
                  "return_code_descrip": "文件正在下载", 
                  "down_id": "bl7z8m9anyu5wvik3dj2s4rheqopg154e117426e7", 
                  "down_progress": 11 
             }

        2、失败

              { 
                   "request_ok": false, 
                  "view_url": null, 
                   "error_msg": "所提供的文件无法下载，文件url地址返回的状态码：404。文件url地址请求 
                   时服务器返回了404文件找不到。", 
                  "return_code": 10, 
                  "return_code_descrip": "文件下载出错", 
                   "down_id": null, 
                   "down_progress": -1 
              }

        request_ok可作为唯一验证是否成功的标志。若在参数中传递了file_attr， 以及fast_return=true，会快速返回结果。

六、预览使用

        后端在正确获取到view_url后，交给前端，前端可直接打开、作为超链接的 href、嵌入iframe均可。

        所有参数意义及具体调用方法，请参考服务支持栏目中的服务指南《OfficeWeb365预览API使用指南v2.pdf》