微信小程序API 登錄

wx.login(OBJECT)

調(diào)用接口獲取登錄憑證（code）進(jìn)而換取用戶登錄態(tài)信息，包括用戶的唯一標(biāo)識（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)絡(luò)請求
          wx.request({
            url: 'https://test.com/onLogin',
            data: {
              code: res.code
            }
          })
        } else {
          console.log('獲取用戶登錄態(tài)失??！' + res.errMsg)
        }
      }
    });
  }
})

code 換取 session_key

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

接口地址：

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"
      "unionid":  "UNIONID"
}
//錯誤時返回JSON數(shù)據(jù)包(示例為Code無效)
{
    "errcode": 40029,
    "errmsg": "invalid code"
}

wx.checkSession(OBJECT)

通過上述接口獲得的用戶登錄態(tài)擁有一定的時效性。用戶越久未使用小程序，用戶登錄態(tài)越有可能失效。反之如果用戶一直在使用小程序，則用戶登錄態(tài)一直保持有效。具體時效邏輯由微信維護(hù)，對開發(fā)者透明。開發(fā)者只需要調(diào)用wx.checkSession接口檢測當(dāng)前用戶登錄態(tài)是否有效。登錄態(tài)過期后開發(fā)者可以再調(diào)用wx.login獲取新的用戶登錄態(tài)。

OBJECT參數(shù)說明：

示例代碼：

wx.checkSession({
  success: function(){
    //session 未過期，并且在本生命周期一直有效
  },
  fail: function(){
    //登錄態(tài)過期
    wx.login() //重新登錄    ....
  }
})

登錄態(tài)維護(hù)

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

通過wx.checkSession()檢測用戶登錄態(tài)是否失效。并決定是否調(diào)用wx.login() 重新獲取登錄態(tài)

登錄時序圖

Bug & Tip

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