主题
鉴权
加入在线文档编辑功能时,可以通过 js-sdk
传递 token
完成鉴权。
设置 token
分 3 个步骤:
- 在线文档预览地址的
url
参数中设置_w_tokentype=1
(注意,这个参数也是需要参与签名的) - 通过
setToken
主动设置token
- 通过在
config
中配置refreshToken
被动刷新token
提示
由于 js-sdk
会提前 5 分钟调用该方法,所以建议设置的 timeout
为 10 分钟以上(10 * 60 * 1000 以上,单位为毫秒),避免刷新过快的问题
// 获取 token 函数
const refreshToken = () => {
// 自身业务处理...
// 可以返回 Promise 或者 return { token, timeout }
return Promise.resolve({
token: 'yourToken', // 必需:你需要设置的 token
timeout: 10 * 60 * 1000, // 必需:token 超时时间,以 10 分钟示例
});
};
// 配置超时获取 token 函数
const jssdk = WebOfficeSDK.config({ refreshToken });
// 设置 token
jssdk.setToken({
token: 'yourToken', // 根据自身的业务需求,通过异步请求或者模板输出的方式,取得 token
timeout: 10 * 60 * 1000, // token 超时时间,可配合 refreshToken 配置函数使用,在超时前调用 refreshToken 重新刷新 token
});