文档转换服务（yifangyun_preview）

描述

文档转换服务(yifangyun_preview)能帮您把各种office文档转换为PDF格式，从而达到在各个浏览器上面预览PDF的效果。

本服务由亿方云科技（以下简称亿方云）提供。启用服务后，您存储在七牛云空间的文件将在您主动请求的情况下被提供给亿方云以供其计算使用。服务价格请您参考具体的价格表及计费举例，您使用本服务产生的费用由七牛代收。启用服务则表示您知晓并同意以上内容。

如何开启

进入https://portal.qiniu.com/service/market, 找到文档转换服务点击开始使用。

请求

请求参数

yifangyun_preview/v2
                    /ext=<Ext>
                    /action=<Action>
                    /format=<DestFormat>
                    /page_number=<PageNumber>

支持转换的文件格式：

word: doc, docx, odt, rtf, wps
ppt: ppt, pptx, odp, dps
excel: xls, xlsx, ods, csv, et

注意：当需要把office转换为图片的时候，需要用本接口把office先转为pdf，然后从pdf转到jpg图片。

请求方式

因为考虑到转换时间会比较久，用http实时转换很容易出现超时，为达到更好的显示效果，需要使用异步处理来进行文档的转换

1. 以预转持久化形式：

   {
       "scope":                "ztest:preview_test.docx",
       "deadline":             1390528576,
       "persistentOps":        "yifangyun_preview",
       "persistentNotifyUrl":  "http://fake.com/qiniu/notify"
   }
   

2. 以触发持久化处理形式，这一部分建议使用七牛提供的各个语言的SDK来处理：

   POST /pfop/ HTTP/1.1
   Host: api.qiniu.com  
   Content-Type: application/x-www-form-urlencoded  
   Authorization: QBox <AccessToken>  
   
   
   bucket=ztest&key=preview_test.docx&fops=yifangyun_preview/v2&notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify
   

示例

1. word格式：
   原文件：http://developer.qiniu.com/resource/preview_test.docx
   对应转换过后的文件：http://developer.qiniu.com/resource/Fnbt4DFz0IjRP5CLyxWvRtR7ny5B

2. ppt格式：
   原文件：http://developer.qiniu.com/resource/preview_test.pptx
   对应转换过后的文件：http://developer.qiniu.com/resource/FhpYDdF3mYRKD4zBen4yYis7qqI1

服务价格

内部参考资源

• 预转持久化处理
• 触发持久化处理