微信小程序API 登錄

wx.login(OBJECT)

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

OBJECT參數(shù)說(shuō)明：

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

示例代碼：

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

code 換取 session_key

?這是一個(gè) HTTPS 接口，開(kāi)發(fā)者服務(wù)器使用登錄憑證 code 獲取 session_key 和 openid。其中 session_key 是對(duì)用戶數(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

請(qǐng)求參數(shù)：

返回參數(shù)：

返回說(shuō)明：

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

wx.checkSession(OBJECT)

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

OBJECT參數(shù)說(shuō)明：

示例代碼：

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

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

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

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

登錄時(shí)序圖

Bug & Tip

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