微信小程序API 登錄

wx.login(OBJECT)

調(diào)用接口獲取登錄憑證（code）進而換取用戶登錄態(tài)信息，包括用戶的唯一標識（openid） 及本次登錄的 會話密鑰（session_key）。用戶數(shù)據(jù)的加解密通訊需要依賴會話密鑰完成。

OBJECT參數(shù)說明：

success返回參數(shù)說明：

示例代碼：

//app.js
App({
  onLaunch: function() {
    wx.login({
      success: function(res) {
        if (res.code) {
          //發(fā)起網(wǎng)絡請求
          wx.request({
            url: 'https://test.com/onLogin',
            data: {
              code: res.code
            }
          })
        } else {
          console.log('獲取用戶登錄態(tài)失??！' + res.errMsg)
        }
      }
    });
  }
})

code 換取 session_key

這是一個 HTTPS 接口，開發(fā)者服務器使用登錄憑證 code 獲取 session_key 和 openid。其中 session_key 是對用戶數(shù)據(jù)進行加密簽名的密鑰。為了自身應用安全，session_key 不應該在網(wǎng)絡上傳輸。

接口地址：

https://api.weixin.qq.com/sns/jscode2session?appid=APPID&secret=SECRET&js_code=JSCODE&grant_type=authorization_code

請求參數(shù)：

返回參數(shù)：

返回說明：

//正常返回的JSON數(shù)據(jù)包
{
      "openid": "OPENID",
      "session_key": "SESSIONKEY"
}
//錯誤時返回JSON數(shù)據(jù)包(示例為Code無效)
{
    "errcode": 40029,
    "errmsg": "invalid code"
}

登錄態(tài)維護

通過 wx.login() 獲取到用戶登錄態(tài)之后，需要維護登錄態(tài)。開發(fā)者要注意不應該直接把 session_key、openid 等字段作為用戶的標識或者 session 的標識，而應該自己派發(fā)一個 session 登錄態(tài)（請參考登錄時序圖）。對于開發(fā)者自己生成的 session，應該保證其安全性且不應該設置較長的過期時間。session 派發(fā)到小程序客戶端之后，可將其存儲在 storage ，用于后續(xù)通信使用。

登錄時序圖

wx.checkSession(OBJECT)

檢查登陸態(tài)是否過期

示例代碼：

wx.checkSession({
  success: function(){    //登錄態(tài)未過期
  },
  fail: function(){    //登錄態(tài)過期
    wx.login()
  }
})

Bug & Tip

1. bug: iOS/Android 6.3.30，在 App.onLaunch 調(diào)用 wx.login 會出現(xiàn)異常；