Programme WeChat Mini - Explication détaillée de la connexion WeChat, du paiement WeChat et des modèles de messages

La plate-forme publique WeChat a récemment commencé discrètement les tests internes de la fonction du mini-programme WeChat (compte public WeChat), attirant l'attention d'innombrables développeurs et utilisateurs ordinaires. La possibilité de payer sur WeChat a été lancée avec la sortie du mini-programme, et son. les fonctionnalités sont présentées comme suit :

wx.login(OBJET)

Appelez l'interface pour obtenir les informations de connexion (code), puis échangez les informations sur l'état de connexion de l'utilisateur, y compris l'identifiant unique de l'utilisateur (openid) et la clé de session (session_key) pour cette connexion. Le cryptage et le déchiffrement des communications de données utilisateur dépendent de la clé de session.

Description du paramètre OBJET :

Exemple de code :

//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)
    }
   }
  });
 }
})

Il s'agit d'une interface HTTP et le serveur de développement utilise le code des informations de connexion pour obtenir la clé de session et l'openid. où session_key est la clé utilisée pour crypter et signer les données utilisateur. Pour des raisons de sécurité des applications, session_key ne doit pas être transmis sur le réseau.

Adresse de l'interface :

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

Paramètres de la requête :

Paramètres de retour :

Instructions de retour :

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

​

Maintenance de l'état de connexion

Après avoir obtenu le statut de connexion de l'utilisateur via wx.login(), le statut de connexion doit être conservé. Les développeurs doivent veiller à ne pas utiliser directement des champs tels que session_key et openid comme identifiants d'utilisateur ou identifiants de session. Au lieu de cela, ils doivent envoyer eux-mêmes un statut de connexion de session (veuillez vous référer au diagramme de séquence de connexion). Pour les sessions générées par les développeurs eux-mêmes, leur sécurité doit être assurée et de longs délais d'expiration ne doivent pas être définis. Une fois la session envoyée au client du mini-programme, elle peut être stockée en mémoire pour une communication ultérieure.

Diagramme de séquence de connexion

wx.checkSession(OBJET)

Vérifiez si le statut de connexion a expiré

Exemple de code :

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

​

Vérification de la signature et cryptage et déchiffrement des données utilisateur

Vérification de la signature des données

Afin de garantir la sécurité des données utilisateur renvoyées par l'interface ouverte, WeChat signera les données en texte brut. Les développeurs peuvent effectuer une vérification de signature sur les paquets de données en fonction des besoins de l'entreprise afin de garantir l'intégrité des données.

L'algorithme de vérification de signature implique la clé de session de l'utilisateur. La clé de session de l'utilisateur est obtenue via le processus de connexion wx.login et la relation correspondante avec le propre état de connexion de l'application est maintenue par elle-même.

Lors de l'obtention de données en appelant une interface (telle que wx.getUserInfo), l'interface renverra rawData et signature en même temps, où signature = sha1 (rawData session_key)

Le développeur envoie la signature et les données brutes au serveur du développeur pour vérification. Le serveur utilise la clé de session correspondante de l'utilisateur pour calculer la signature signature2 en utilisant le même algorithme, et compare signature et signature2 pour vérifier l'intégrité des données.

Tels que la vérification des données de wx.getUserInfo :

rawData renvoyé par l'interface :

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

​

Clé de session de l'utilisateur :

HyVFkGl5F5OQWJZZaNzBBg==

Ainsi, la chaîne utilisée pour la signature est :

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

​

Le résultat obtenu en utilisant sha1 est

75e81ceda165f4ffa64f4068af58c64b8f54b88c

Algorithme de décryptage des données cryptées

Si l'interface implique des données sensibles (telles que openId et unionId dans wx.getUserInfo), le contenu en texte brut de l'interface ne contiendra pas ces données sensibles. Si les développeurs ont besoin d'obtenir des données sensibles, ils doivent déchiffrer symétriquement les données chiffrées (encryptedData) renvoyées par l'interface. L'algorithme de décryptage est le suivant :

L'algorithme utilisé pour le décryptage symétrique est AES-128-CBC et les données sont complétées avec PKCS#7.

Le texte chiffré cible pour le déchiffrement symétrique est Base64_Decode(encryptedData),

Clé de déchiffrement symétrique aeskey = Base64_Decode (session_key), aeskey fait 16 octets

对称解密算法初始向量 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

登录https://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",
}