WPS预览集成
1. 概述
1.1 功能简介
WPS 预览集成指的是,成员在企业业务处理过程中,进行 Excel 、word 预览时,通过调用 WPS 服务实现预览效果。
1.2 应用场景
适用于集团内需要严格使用国产化资源的各类场景中。
2. 准备独享版企业访问地址
管理员登录独享版控制台,点击「基础信息」,在「平台信息」处即可获取独享版企业访问地址。
请复制并保存,下文需要使用。

3. WPS端配置
3.1 登录WPS
开发者注册并 登录 WPS 开放平台。
3.2 开发者认证
1)进入开放平台「控制台」中,在「总览 >> 开发者认证」处,点击「去认证」。
2)进入开发者认证页面,填写好开发者名称、邮箱、联系电话等信息后,点击「提交」,完成认证。
3.3 创建测试应用
在「创建测试应用」处,点击「免费创建测试应用」。进入创建应用页面中,设置好应用名称、应用介绍,选择应用类型和应用环境后,点击「创建应用」,完成创建。
3.4 获取AppID和AppSecret
应用创建完成后,在「应用管理 >> 应用」处点击「配置」,进入应用信息详情页中,查看并保存应用的AppID 和 AppSecret。
3.4 配置回调地址
在应用的「回调配置 > 回调网关」处,配置对应的回调地址。
回调地址配置格式:第2节独享版企业访问地址/_/file/wps
例如:https://example.com:8080/test/_/file/wps
3.5 开启端口
开启如下所示 2 类端口:
- 文档预览:文档预览中的 3 个端口均默认开启;
- 用户信息:用户信息中的 1 个接口需手动开启。
4. 独享版控制台配置
管理员登录独享版控制台,在「系统管理 > 集成配置 > Office 预览配置」中,进行如下所示配置:
- 预览方案:选择「WPS」;
- app_id:将 3.4 节获取到的 APPID 配置进去;
- app_key:将 3.4 节获取到的 APPSecret 配置进去。
全部设置完成后,点击「保存」按钮。

5. 注意事项
5.1 IP白名单配置
内网用户需开启 IP 白名单,可选用回调 IP 地址:120.92.55.139。
若回调地址失败,可参考 回调服务出口 IP 并根据企业需求自行选取。
5.2 预览失败问题
若集成预览失败,可检查以下配置是否正确,并重新尝试预览:
- WPS 回调地址配置是否正确
- IP 白名单地址是否开启
5.3 创建正式应用
根据 2~4 节完成 WPS 预览集成测试工作后,需在「WPS 开放平台 > 总览」处,根据企业需求创建正式应用并进行集成。

400-111-0890
在线咨询