Ausführliche Erläuterung von Beispielen für Anmelde-, Zahlungs- und Vorlagennachrichten für die Entwicklung von Miniprogrammen

In diesem Artikel werden hauptsächlich WeChat-Miniprogramme vorgestellt – WeChat-Anmeldung, WeChat-Zahlung und Vorlagennachrichten. Er hat einen gewissen Referenzwert und Sie können bei Bedarf mehr darüber erfahren.

Die öffentliche WeChat-Plattform hat vor kurzem in aller Stille mit dem internen Testen der Funktion des WeChat-Miniprogramms (öffentliches WeChat-Konto) begonnen und damit die Aufmerksamkeit unzähliger Entwickler und normaler Benutzer auf sich gezogen. Die Möglichkeit, auf WeChat zu bezahlen, wurde mit der Veröffentlichung von eingeführt Das Miniprogramm lautet wie folgt:

wx.login(OBJECT)

Rufen Sie die Schnittstelle auf, um die Anmeldeinformationen zu erhalten ( Code) und tauschen Sie dann die Anmeldestatusinformationen des Benutzers aus, einschließlich der eindeutigen Kennung des Benutzers (openid) und des Sitzungsschlüssels (session_key) für diese Anmeldung. Die Verschlüsselung und Entschlüsselung der Benutzerdatenkommunikation hängt vom Sitzungsschlüssel ab.

OBJECT-Parameterbeschreibung:

Erfolgsrückgabeparameterbeschreibung:

Beispielcode:

//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 im Austausch für session_key

Dies ist eine HTTP-Schnittstelle. Der Entwicklerserver verwendet den Anmeldeinformationscode, um session_key und openid zu erhalten. Dabei ist session_key der Schlüssel, der zum Verschlüsseln und Signieren von Benutzerdaten verwendet wird. Zur Sicherheit Ihrer eigenen Anwendung sollte der Sitzungsschlüssel nicht hochgeladen werden und im Netzwerk verloren gehen.

Schnittstellenadresse:

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

Parameter anfordern :

Rückgabeparameter:

Rückgabebeschreibung:

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

Anmeldestatuspflege

Nachdem der Benutzeranmeldestatus über wx.login() erhalten wurde, muss der Anmeldestatus beibehalten werden. Entwickler sollten darauf achten, Felder wie session_key und openid nicht direkt als Benutzerkennungen oder Sitzungskennungen zu verwenden. Stattdessen sollten sie selbst einen Sitzungsanmeldestatus auslösen (siehe Anmeldesequenzdiagramm). Für von Entwicklern selbst generierte Sitzungen sollte deren Sicherheit gewährleistet sein und keine langen Ablaufzeiten festgelegt werden. Nachdem die Sitzung an den Miniprogramm-Client gesendet wurde, kann sie für die spätere Kommunikation im Speicher gespeichert werden.

Anmeldesequenzdiagramm

wx.checkSession(OBJECT)

Überprüfen Sie den Anmeldestatus ist abgelaufen

Beispielcode:

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

Signaturüberprüfung sowie Ver- und Entschlüsselung von Benutzerdaten

Überprüfung der Datensignatur

Um die Sicherheit der von der offenen Schnittstelle zurückgegebenen Benutzerdaten zu gewährleisten, signiert WeChat die Klartextdaten. Entwickler können je nach Geschäftsanforderungen eine Signaturüberprüfung von Datenpaketen durchführen, um die Datenintegrität sicherzustellen.

• Der Signaturüberprüfungsalgorithmus umfasst den Sitzungsschlüssel des Benutzers, der über den wx.login-Anmeldevorgang abgerufen wird und die entsprechende Beziehung zum eigenen Anmeldestatus der Anwendung aufrechterhält.

• Beim Abrufen von Daten durch Aufrufen einer Schnittstelle (z. B. wx.getUserInfo) gibt die Schnittstelle gleichzeitig Rohdaten und Signatur zurück, wobei Signatur = sha1( rawData + session_key )

• Der Entwickler sendet Signatur und Rohdaten zur Überprüfung an den Entwicklerserver. Der Server verwendet den entsprechenden Sitzungsschlüssel des Benutzers, um die Signatur Signatur2 mit demselben Algorithmus zu berechnen, und vergleicht Signatur und Signatur2, um die Integrität der Daten zu überprüfen.
  

Zum Beispiel Datenüberprüfung von wx.getUserInfo:

von der Schnittstelle zurückgegebene Rohdaten:

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

Sitzungsschlüssel des Benutzers :

HyVFkGl5F5OQWJZZaNzBBg==

Die für die Signatur verwendete Zeichenfolge lautet also:

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

Das mit sha1 erhaltene Ergebnis ist

75e81ceda165f4ffa64f4068af58c64b8f54b88c

Verschlüsselter Datenentschlüsselungsalgorithmus

Wenn die Schnittstelle vertrauliche Daten umfasst (z. B. openId und un in wx.getUserInfo ionId) enthält der Klartextinhalt der Schnittstelle diese vertraulichen Daten nicht. Wenn Entwickler vertrauliche Daten erhalten müssen, müssen sie die von der Schnittstelle zurückgegebenen verschlüsselten Daten (encryptedData) symmetrisch entschlüsseln. Der Entschlüsselungsalgorithmus lautet wie folgt:

• Der für die symmetrische Entschlüsselung verwendete Algorithmus ist AES-128-CBC und die Daten werden mit PKCS#7 gefüllt.

• Der Ziel-Chiffretext der symmetrischen Entschlüsselung ist Base64_Decode(encryptedData),

• Der geheime Schlüssel der symmetrischen Entschlüsselung aeskey = Base64_Decode(session_key), aeskey ist 16 Bytes

• Der Anfangsvektor iv des symmetrischen Entschlüsselungsalgorithmus wird in der Datenschnittstelle zurückgegeben.
  

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

注：此前提供的加密数据（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",
}