文档转换服务(yifangyun_preview)
描述
文档转换服务(yifangyun_preview)能帮您把各种office文档转换为PDF格式,从而达到在各个浏览器上面预览PDF的效果。
本服务由亿方云科技(以下简称亿方云)提供。启用服务后,您存储在七牛云空间的文件将在您主动请求的情况下被提供给亿方云以供其计算使用。服务价格请您参考具体的价格表及计费举例,您使用本服务产生的费用由七牛代收。启用服务则表示您知晓并同意以上内容。
如何开启
进入https://portal.qiniu.com/service/market, 找到文档转换服务点击开始使用。
请求
请求参数
yifangyun_preview/v2
/ext=
/action=
/format=
/page_number=
参数
必填
说明
Ext
否
当key的后缀不是文件的正确格式时,可以在这个参数中指定对应的格式,优先级大于key的后缀
Action
否
1. get_preview:获取文件预览(默认行为)
2. get_page_count:获取文件页码
DestFormat
否
目标格式
1. pdf(默认)
2.jpg当需要把office文档的某一页面转为jpg图片时,需要指定对应的页码并且原文件必须是pdf格式
PageNumber
否
文件的页码
支持转换的文件格式:
word: doc, docx, odt, rtf, wps
ppt: ppt, pptx, odp, dps
excel: xls, xlsx, ods, csv, et
注意:当需要把office转换为图片的时候,需要用本接口把office先转为pdf,然后从pdf转到jpg图片。
请求方式
因为考虑到转换时间会比较久,用http实时转换很容易出现超时,为达到更好的显示效果,需要使用异步处理来进行文档的转换
{
"scope": "ztest:preview_test.docx",
"deadline": 1390528576,
"persistentOps": "yifangyun_preview",
"persistentNotifyUrl": "http://fake.com/qiniu/notify"
}
以触发持久化处理形式,这一部分建议使用七牛提供的各个语言的SDK来处理:
POST /pfop/ HTTP/1.1
Host: api.qiniu.com
Content-Type: application/x-www-form-urlencoded
Authorization: QBox
bucket=ztest&key=preview_test.docx&fops=yifangyun_preview/v2¬ifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify
示例
word格式:
原文件:http://developer.qiniu.com/resource/preview_test.docx
对应转换过后的文件:http://developer.qiniu.com/resource/Fnbt4DFz0IjRP5CLyxWvRtR7ny5B
ppt格式:
原文件:http://developer.qiniu.com/resource/preview_test.pptx
对应转换过后的文件:http://developer.qiniu.com/resource/FhpYDdF3mYRKD4zBen4yYis7qqI1
服务价格
每千页PPT
每千页Word
每千个Excel的sheet
价格
0.3元
0.1元
0.1元
内部参考资源