# ks.checkSession

# ks.checkSession(Object object)

# 功能描述

检查 ks.login 返回的登录态是否过期。session_key 存在一定的有效期，用户使用小游戏越频繁，有效期越长，session_key 过期后需重新调用 ks.login 登录。但是若前端在session_key 尚未过期时调用 ks.login ，会导致会话被刷新，产生新的 session_key，小游戏服务器存储的 session_key 也随即失效，所以应正确使用 ks.login 和 ks.checkSession 。

# 参数

Object object

属性	类型	必填	说明
success	function	否	登录态未过期的回调函数
fail	function	否	登录态失效的回调函数
complete	function	否	登录态检查完成回调，无论登录态是否有效都会执行

Object.fail 回调函数参数

属性	类型	说明
code	number	错误码：-20038：未登录或登录态失效，需重新登录-20001：未知错误（如网络连接失败等），请重试
msg	string	错误信息

# 示例代码

ks.checkSession({
  success: function() {
    //登录态有效
  },
  fail: function() {
    // 错误处理
  }
})

← ks.login auth.code2Session →