詳解小程式開發登陸、付款和範本訊息的實例

本篇文章主要是介紹了微信小程式-微信登陸、微信支付、範本訊息，具有一定的參考價值，有需要的可以了解一下。

微信公眾平台近日悄悄開始內測微信小程式(微信公眾號)功能,引來無數開發者和普通用戶關注，微信支付的能力,是隨著小程式的發布一併推出的,具有介紹如下：

wx.login(OBJECT)

呼叫介面取得登入憑證（code）進而換取使用者登入狀態訊息，包含使用者的唯一識別（openid） 及本次登入的會話金鑰（session_key）。使用者資料的加解密通訊需要依賴會話金鑰完成。

OBJECT參數說明：

success傳回參數說明：

範例程式碼：

//app.js
App({
 onLaunch: function() {
  wx.login({
   success: function(res) {
    if (res.code) {
     //发起网络请求
     wx.request({
      url: 'https://test.com/onLogin',
      data: {
       code: res.code
      }
     })
    } else {
     console.log('获取用户登录态失败！' + res.errMsg)
    }
   }
  });
 }
})

code換取session_key

這是一個HTTP 接口，開發者伺服器使用登入憑證code 來取得session_key 和openid。其中 session_key 是對使用者資料進行加密簽署的金鑰。為了自行應用安全性，session_key 不應該在網路上傳輸。

介面位址：

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

請求參數：

傳回參數：

#回傳說明：

//正常返回的JSON数据包
{
   "openid": "OPENID",
   "session_key": "SESSIONKEY"
   "expires_in": 2592000
}
//错误时返回JSON数据包(示例为Code无效)
{
  "errcode": 40029,
  "errmsg": "invalid code"
}

登入態維護

透過wx.login() 取得到使用者登入態之後，需要維護登入態。開發者要注意不應該直接把 session_key、openid 等欄位當作使用者的標識或 session 的標識，而應該自己派發一個 session 登入態（請參考登入時序圖）。對於開發者自己產生的 session，應該保證其安全性且不應該設定較長的過期時間。 session 派發到小程式用戶端之後，可儲存在 storage ，用於後續通訊使用。

登入時序圖

wx.checkSession(OBJECT)

檢查登陸態是否過期

範例程式碼：

wx.checkSession({
 success: function(){
  //登录态未过期
 },
 fail: function(){
  //登录态过期
  wx.login()
 }
})

使用者資料的簽章驗證與加上解密

資料簽章校驗

為了確保開放介面回傳使用者資料的安全性，微信會對明文資料進行簽署。開發者可以根據業務需求對資料包進行簽章校驗，確保資料的完整性。

• 簽署校驗演算法涉及使用者的session_key，透過 wx.login 登入流程取得使用者session_key，並自行維護與應用自身登入態的對應關係。

• 透過呼叫介面（如wx.getUserInfo）取得資料時，介面會同時傳回rawData、signature，其中signature = sha1( rawData + session_key )

• 開發者將signature、rawData 傳送到開發者伺服器進行校驗。伺服器利用使用者對應的 session_key 使用相同的演算法計算出簽章 signature2 ，比對 signature 與 signature2 即可校驗資料的完整性。
  

如wx.getUserInfo的資料校驗：

介面傳回的rawData：

{
 "nickName": "Band",
 "gender": 1,
 "language": "zh_CN",
 "city": "Guangzhou",
 "province": "Guangdong",
 "country": "CN",
 "avatarUrl": "http://wx.qlogo.cn/mmopen/vi_32/1vZvI39NWFQ9XM4LtQpFrQJ1xlgZxx3w7bQxKARol6503Iuswjjn6nIGBiaycAjAtpujxyzYsrztuuICqIM5ibXQ/0"
}

使用者的session-key：

HyVFkGl5F5OQWJZZaNzBBg==

所以，用於簽章的字串為：

{
 "nickName": "Band",
 "gender": 1,
 "language": "zh_CN",
 "city": "Guangzhou",
 "province": "Guangdong",
 "country": "CN",
 "avatarUrl": "http://wx.qlogo.cn/mmopen/vi_32/1vZvI39NWFQ9XM4LtQpFrQJ1xlgZxx3w7bQxKARol6503Iuswjjn6nIGBiaycAjAtpujxyzYsrztuuICqIM5ibXQ/0"
}HyVFkGl5F5OQWJZZaNzBBg==

使用sha1得到的結果為

75e81ceda165f4ffa64f4068af58c64b8f54b88c

加密資料解密演算法

#介面如果涉及敏感資料（如wx.getUserInfo當中的openId 和

##介面如果涉及敏感資料（如wx.getUserInfo當中的openId 和##unionId ），介面的明文介面的明文內容將不包含這些敏感資料。開發者如需要取得敏感數據，需要對介面傳回的加密資料( encryptedData )進行對稱解密。 解密演算法如下：
對稱解密所使用的演算法為 AES-128-CBC，資料採用PKCS#7填入。
對稱解密的目標密文為Base64_Decode(encryptedData),
對稱解密密鑰aeskey = Base64_Decode(session_key), aeskey 是16位元組

• 
  

  對稱解密演算法初始向量iv 會在資料介面中傳回。 ######

微信官方提供了多种编程语言的示例代码（点击下载）。每种语言类型的接口名字均一致。调用方式可以参照示例。

注：此前提供的加密数据（encryptData）以及对应的加密算法将被弃用，请开发者不要再依赖旧逻辑。

用户信息：

### wx.getUserInfo(OBJECT)

获取用户信息，需要先调用 wx.login 接口。

OBJECT参数说明：

success返回参数说明：

示例代码：

wx.getUserInfo({
 success: function(res) {
  var userInfo = res.userInfo
  var nickName = userInfo.nickName
  var avatarUrl = userInfo.avatarUrl
  var gender = userInfo.gender //性别 0：未知、1：男、2：女 
  var province = userInfo.province
  var city = userInfo.city
  var country = userInfo.country
 }
})

encryptedData 解密后为以下 json 结构，详见加密数据解密算法

{
  "appId": "APPID",
  "openId": "OPENID",
  "nickName": "NICKNAME",
  "gender": 1,
  "city": "CITY",
  "province": "PROVINCE",
  "country": "COUNTRY",
  "avatarUrl": "AVATARURL",
  "unionId": "UNIONID"
}

UnionID机制说明：

如果开发者拥有多个移动应用、网站应用、和公众帐号（包括小程序），可通过unionid来区分用户的唯一性，因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号（包括小程序），用户的unionid是唯一的。换句话说，同一用户，对同一个微信开放平台下的不同应用，unionid是相同的。

微信开放平台绑定小程序流程

前提：微信开放平台帐号必须已完成开发者资质认证

开发者资质认证流程：

登录微信开放平台(open.weixin.qq.com) – 帐号中心 – 开发者资质认证

微信支付：

wx.requestPayment(OBJECT)
发起微信支付。

Object参数说明：

示例代码：

wx.requestPayment({
  'timeStamp': '',
  'nonceStr': '',
  'package': '',
  'signType': 'MD5',
  'paySign': '',
  'success':function(res){
  },
  'fail':function(res){
  }
})

基于微信的通知渠道，我们为开发者提供了可以高效触达用户的模板消息能力，以便实现服务的闭环并提供更佳的体验。

模板推送位置：服务通知

模板下发条件：用户本人在微信体系内与页面有交互行为后触发，详见下发条件说明

模板跳转能力：点击查看详情仅能跳转下发模板的该帐号的各个页面

使用说明

获取模板 id

登录mp.weixin.qq.com获取模板，如果没有合适的模板，可以申请添加新模板，审核通过后可使用，详见模板审核说明

页面的

{"access_token": "ACCESS_TOKEN", "expires_in": 7200}

{
 "touser": "OPENID", 
 "template_id": "TEMPLATE_ID", 
 "page": "index",     
 "form_id": "FORMID",     
 "data": {
   "keyword1": {
     "value": "339208499", 
     "color": "#173177"
   }, 
   "keyword2": {
     "value": "2015年01月05日 12:30", 
     "color": "#173177"
   }, 
   "keyword3": {
     "value": "粤海喜来登酒店", 
     "color": "#173177"
   } , 
   "keyword4": {
     "value": "广州市天河区天河路208号", 
     "color": "#173177"
   } 
 },
 "emphasis_keyword": "keyword1.DATA" 
}

{
 "errcode": 0,
 "errmsg": "ok",
}