金山文档采用Oauth2.0认证方式进行账号的授权。

一、申请开发者账号

进入WPS开放平台（https://open.wps.cn/），申请开发者账号及应用。申请完成如下： 

进入应用查看相关信息：

二、新增连接配置

在集成服用云中，新增连接配置，选择金山文档，将之前申请的应用的APPID和APPKEY填写到配置界面中，如下图所示：

保存后点击认证，弹出金山文档认证界面，扫码成功后自动填充refresh_token参数， refresh_token自动填充后再保存。

注意：WPS账号必须实名认证。在微信扫码登录后，未实名用户在微信端会弹出实名认证提醒消息！

三、关联数据源

关联数据源，在数据源管理列表中，打开预置_金山文档，编码为KD_WPS，并按图所示配置系统连接。

四、预置系统API登记及测试

1、获取文件列表

编码：wps_get_file_list

需要授权：否记录日志：否备注：接口详情请参考文档：/tolink?target=https%3A%2F%2Fopen.wps.cn%2Fdocs%2Fpersonal-doc%2Fapi-infoURL:/kapi/v2/iscb/route/ex_wps_get_file_list调用方法：POST

API介绍

根据open_parentid（ 文件夹所在父目录id）查找该目录下的所有文件。

请求头部：

获取token详见：https://dev.kingdee.com/index/docsNew/6668c5c0-b547-4f55-8f74-cc6ea2f5c65c

输入：

输出：

输入样例：

{
　　    "open_parentid":"0"
　　}

输出样例：

{
    "data":{
        "result":0,
        "files":[
            {
                "file_name":"test.xlsx",
                "file_type":"sharefile",
                "open_fileid":"opIjekSZ7xLHSsZ07HuVxWAA",
                "ctime":1660030830,
                "mtime":1660030830,
                "file_size":3386
            },
            {
                "file_name":"test2.xlsx",
                "file_type":"sharefile",
                "open_fileid":"opyXwIKgH-fc7HPpAhF-5qpw",
                "ctime":1656402466,
                "mtime":1656494039,
                "file_size":11708
            }
        ]
    },
    "errorCode":"success",
    "success":true
}

失败样例：

{
"success":false,
"errorCode":"fail",
"message":"错误堆栈详情"
}

API测试结果：

2、获取文件下载链接

编码：wps_get_file_download_url

需要授权：否

记录日志：否

备注：接口详情请参考文档：/tolink?target=https%3A%2F%2Fopen.wps.cn%2Fdocs%2Fpersonal-doc%2Fapi-info

URL:/kapi/app/iscb/ex_get_file_download_url

调用方法：POST

API介绍

根据文件id获取其下载链接。

请求头部：

获取token详见：

https://dev.kingdee.com/index/docsNew/6668c5c0-b547-4f55-8f74-cc6ea2f5c65c

输入：

输出：

 输入样例：

{
　　    "open_fileid":""
　　}

输出样例：

{
"data":{
　　    "result":0,
　　    "url":""
　　}
   "success":true,
"errorCode":"success"
}

失败样例：

{
"success":false,
"errorCode":"fail",
"message":"错误堆栈详情"
}

API测试结果：

3、获取文件分享链接

编码：wps_get_file_link

需要授权：否

记录日志：否

备注：

URL:/kapi/app/iscb/ex_wps_get_file_link

调用方法：POST

API介绍

根据文件id获取其在线分享链接。

请求头部：

获取token详见：

https://dev.kingdee.com/index/docsNew/6668c5c0-b547-4f55-8f74-cc6ea2f5c65c

输入：

输出：

输入样例：

{
　　    "open_fileid":""
　　}

输出样例：

{
"data":{
　　    "result":0,
　　    "file_name":"",
　　    "link_url":""
　　}
   "success":true,
"errorCode":"success"
}

失败样例：

{
"success":false,
"errorCode":"fail",
"message":"错误堆栈详情"
}

API测试结果：

五、服务流程设计

下面是文件上传相关API和脚本，上传文件分为三步：

1. 使用请求文件上传接口获取上传链接

2. 使用获取到的上传链接上传文件

3. 文件上传完之后调用上传文件提交接口提交文件

1、请求文件上传

编码：wps_file_upload_request

需要授权：否

记录日志：是

备注：接口详情请参考文档：/tolink?target=https%3A%2F%2Fopen.wps.cn%2Fdocs%2Fpersonal-doc%2Fapi-info

URL:/kapi/app/iscb/ex_wps_file_upload_request

调用方法：POST

API介绍

文件上传的第一步，通过此接口可以获取上传文件的链接等信息 

请求头部：

获取token详见：

https://dev.kingdee.com/index/docsNew/6668c5c0-b547-4f55-8f74-cc6ea2f5c65c

输入：

输出：

输入样例：

{
　　    "open_parentid":0,
　　    "size":0,
　　    "name":"",
　　    "sha1":""
　　}

输出样例：

{
　　    "data":{
　　        "result":0,
　　        "data":{
　　            "uploadinfo":{
　　                "headers":{},
　　                "put_auth":{
　　                    "upload_url":""
　　                }
　　            }
　　        }
　　    },
　　    "success":true,
　　    "errorCode":"success"
　　}

2、上传文件实体

API介绍

文件上传的第二步，上传文件实体

因该API特殊，可参考如下脚本写法，在流程中使用。接口详情请参考文档：

https://open.wps.cn/docs/personal-doc/api-info

{
　　    "open_parentid":"",
　　    "size":0,
　　    "sha1":"",
　　    "name":"",
　　    "etag":"",
　　    "add_name_index":false
　　}

{
　　    "data":{
　　        "result":0,
　　        "data":{
　　            "file_name":"",
　　            "open_fileid":""
　　        }
　　    },
　　    "success":true,
　　    "errorCode":"success"
　　}