WPS文档在线预览接入的一点心得

花了大半天时间接入WPS文档在线预览功能，还算比较顺利。

原来的OA系统一直用到文档在线预览功能，之前是用微软+officeweb365来实现的。一直感觉不太理想。昨天无意间见到金山WPS开放了在线文档预览的功能接入，于是申请了服务商。服务商申请成功后，提交文档在线预览的服务申请。

官网的接入文档相当简单，而且也没有PHP的demo可参考。只好摸着石头过河去测试。

1、按照开发文档首先写了一个回调接口，这个在开发第三方支付时，已经写过了，这个是比较简单的；按照文档的要求返回正确的参数即可；

这里面是有一个小坑的：对于回调返回的参数的数据类型是相当严格的，必须和示例的一致，否则会返回无效链接。比如size是整型的，我在测试时因为是通过filesize函数直接获取的，是没问题的，后来正式在业务中使用时则是通过参数传过来就出问题了，因为变成字符型的数据类型了；另外在回调中filesize不能用相对路径，必须是完整的路径；

2、按照签名生成文档写一个加签函数。这个需要注意几点：

2.1 PHP的hash_hmac函数需要传入四个参数，分别是：‘SHA1’，排序后拼接成的字符串，APPKEY，‘true’，这个在开发文档里是没有的；

2.2 secretkey不参与排序，不参与加签，放到最后面，其值即为APPKEY，叫法不一样，都是一个东西；

3、请求链接拼接，中文需要urlencode。