实战应用WPS WebOffice开放平台服务

概述

根据公司的业务需要，主要功能是在线编辑文档，前端的小伙伴进行的技术调研，接入的是WPS WebOffice，这里只阐述技术介入的步骤、流程和遇到的坑进行的一些总结。

实践

WPS WebOffice 开放平台进行认证

在开始之前，需要在WPS WebOffice 开放平台进行注册和认证，添加应用，申请成功后如下图所示：

开发和接入

在开始编写代码之前，有三个关键概念要提前了解 webClient（前端客户端）、 WpsServers（Wps服务）、CrmServers(服务端)，请求流程: 前端客户端请求Wps服务，Wps服务请求服务端，进行通知、回调操作。

具体实现，图中左侧是我们具体业务逻辑，右侧是Wps服务请求我们的服务端：

1.配置路由:WPS WebOffice

开放平台url都是官方定义好的，用路径拼接好的，服务端需要定义一个

全局${file_id}

来进行通信,强烈推荐在服务端配置自定义路由，这样的实现简单便捷，也可以在Nginx使用重定向进行解决,参数通过截取Url得到。

/** wps 在线文档自定义路由 */$route['v3/3rd/files/(:any)']='wps/test/files/$1/$2/$3';$route['v3/3rd/users']='wps/test/users';$route['v3/3rd/notify']='wps/test/notify';

2.预览

在前端预览的时候，Wps服务文件信息、文件权限、文件下载地址、用户信息4个接口，返回格式要和文档上的一致，不然会产生权限不足的错误，查找起来也是很困难，在这里也说一下接口说明：

120.92.55.139 - - [24/Oct/2024:07:23:57 +0800]"GET /v3/3rd/users?user_ids=45 HTTP/1.1"20089"-""Go-http-client/1.1"120.92.55.139 - - [24/Oct/2024:07:23:57 +0800]"GET /v3/3rd/files/HT4319/permission HTTP/1.1"200131"-""Go-http-client/1.1"120.92.55.139 - - [24/Oct/2024:07:24:08 +0800]"GET /v3/3rd/files/HT4319 HTTP/1.1"200177"-""Go-http-client/1.1"120.92.55.139 - - [24/Oct/2024:07:24:08 +0800]"GET /v3/3rd/files/HT4319/download HTTP/1.1"200137"-""Go-http-client/1.1"

• /v3/3rd/users ：获取用户信息接口，用于在线文件操作中的显示和记录。
• /v3/3rd/files/HT4319/permission : 获取当前文件可以操作的权限
• /v3/3rd/files/HT4319 ：获取文件的基本信息、创建文件用户、大小等等
• /v3/3rd/files/HT4319/download：最容易出错的是这个接口，这个接口中要返回的是文档可以下载的url路径，Wps服务要来这里获取文件数据流。

3.保存

在操作的过程中，每保存一次文件，他就会请求URL一次，我们使用的这个版本用的是三阶段提交，具体阐述如下：

120.92.55.139 - - [24/Oct/2024:07:37:56 +0800]"GET /v3/3rd/files/HT4319/upload/prepare HTTP/1.1"20086"-""Go-http-client/1.1"120.92.55.139 - - [24/Oct/2024:07:37:56 +0800]"POST /v3/3rd/files/HT4319/upload/address HTTP/1.1"200186"-""Go-http-client/1.1"120.92.55.139 - - [24/Oct/2024:07:37:56 +0800]"GET /v3/3rd/files/HT4319/permission HTTP/1.1"200131"-""Go-http-client/1.1"120.92.55.139 - - [24/Oct/2024:07:37:56 +0800]"POST /v3/3rd/files/HT4319/upload/complete HTTP/1.1"200179"-""Go-http-client/1.1"

• /v3/3rd/files/HT4319/upload/prepare : 这个接口的作用是Wps服务与本地服务端协商摘要算法,有 md5 sha1 sha256三个选项，多接口的交互需要保持一致。
• /v3/3rd/files/HT4319/upload/address : 这个接口的作用是在编辑的过程中，告诉Wps服务保存文件的Api，Wps服务以文件流的形式来进行请求
• /v3/3rd/files/HT4319/upload/complete：Wps服务保存完成后，回调这个接口

以我的

/v3/3rd/files/HT4319/upload/address

接口为例,返回的完整Json结构,作用是在文件在线编辑的过程中去同步请求url的指定接口。

{
    "code": 0,
    "data": {
        "method": "PUT",
        "url": "https://www.stark.com/api/laborcontract_wps/save_wps",
        "params": {
            "file_id": "HT4308",
            "name": ""
        }
    },
    "message": ""
}

有两个注意的点，开发过程中，最大的难点就在这里了。
1、save_wps接收的参数是通过upload/address params 传递的，我的

$this->posts

是参数数组
2、接收到的文件流，重写到指定地址，覆盖之前的文件地址

$savePath

publicfunctionsave_wps(){#接收参数$file_id=isset($this->posts['file_id'])?$this->posts['file_id']:'';//接收文件流，覆盖文件$stream=file_get_contents('php://input');file_put_contents($savePath,$con);}

4.其他

文档重命名、水印、用户列表、会话通知其他接口就比较简单，不在这里一一赘述了，如果有需要的可以私信我，给我留言。