背景
接入云文档中间页,在中间页处理跳转云文档登录页还是通过协作deeplink打开协作客户端,打开协作客户端时获取用户信息的code码,code可换取用户信息,使用 DeepLink 的方式实现三方 Web 端唤起协作客户端,并实现免登录处理。
接入方案
接入云文档中间页
服务商或者接入方自行实现跳转链接:域名 + /kdrive/woaSilentLogin/
后续的唤起客户端无需服务商或者接入方实现,已在云文档中间页处理,下面做下原理介绍:
原理介绍
在云文档中间页确认打开协作客户端时,会经过以下步骤:
1.获取用户信息的code码
| 请求地址 | /accounts/u/v1/session/correlate |
|---|---|
| 请求方法 | Get |
请求地址示例
http
[GET] https://account.wps.cn/p/session/correlate2.获取 code,拼接生成DeepLink 链接
DeepLink
http
ksoxz://xz.wps.cn/login?auth_code={code}调用示例
http
window.open('ksoxz://xz.wps.cn/login?auth_code={code}')3.跳转结果
- 登录成功:页面重新加载,刷新后登录新用户账号
- 登录失败:提示报错“无效请求,请重试!”
- 登录身份和当前用户不一致:则自动切换为浏览器中用户账号,提示如下图:

4.错误码
- 401001003 :无效的session
- 401001005 :账户未登录