WeChat ミニ プログラム - WeChat ログイン、WeChat 支払い、テンプレート メッセージの詳細な説明

WeChat パブリック プラットフォームは最近、WeChat ミニ プログラム (WeChat パブリック アカウント) 機能の内部テストを静かに開始し、無数の開発者と一般ユーザーの注目を集めています。WeChat での支払い機能は、ミニ プログラムのリリースとともに開始されました。機能は次のように紹介されます。

wx.login(オブジェクト)

インターフェイスを呼び出してログイン資格情報 (コード) を取得し、ユーザーの一意の識別子 (openid) やこのログインのセッション キー (session_key) などのユーザー ログイン ステータス情報を交換します。ユーザーデータ通信の暗号化と復号化はセッションキーに依存します。

OBJECT パラメータの説明:

サンプルコード:

これは HTTP インターフェイスであり、開発者サーバーはログイン資格情報コードを使用して session_key と openid を取得します。ここで、 session_key は、ユーザー データの暗号化と署名に使用されるキーです。アプリケーションのセキュリティのため、session_key はネットワーク経由で送信しないでください。

インターフェースアドレス:

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

リクエストパラメータ:

戻りパラメータ:

返品手順:

​

ログイン状態のメンテナンス

wx.login()でユーザーのログイン状態を取得した後は、ログイン状態を維持する必要があります。開発者は、session_key や openid などのフィールドをユーザー識別子またはセッション識別子として直接使用しないように注意し、代わりにセッション ログイン ステータスを自分でディスパッチする必要があります (ログイン シーケンス図を参照してください)。開発者自身が生成したセッションの場合、セキュリティを確保し、長い有効期限を設定すべきではありません。セッションがミニ プログラム クライアントにディスパッチされた後、後続の通信のためにストレージに保存できます。

ログインシーケンス図

wx.checkSession(OBJECT)

ログインステータスの有効期限が切れていないか確認する

サンプルコード:

​

ユーザーデータの署名検証と暗号化および復号化

データ署名の検証

オープン インターフェイスから返されるユーザー データのセキュリティを確保するために、WeChat はプレーン テキスト データに署名します。開発者は、ビジネス ニーズに基づいてデータ パケットの署名検証を実行し、データの整合性を確保できます。

署名検証アルゴリズムにはユーザーの session_key が含まれます。ユーザーの session_key は、wx.login ログイン プロセスを通じて取得され、アプリケーション自体のログイン状態との対応関係が維持されます。

インターフェイス (wx.getUserInfo など) を呼び出してデータを取得すると、インターフェイスは rawData と署名を同時に返します。ここで、signature = sha1(rawData + session_key)

開発者は検証のために署名と rawData を開発者サーバーに送信します。サーバーは、ユーザーの対応する session_key を使用して、同じアルゴリズムを使用して署名 Signature2 を計算し、signature と Signature2 を比較してデータの整合性を検証します。

wx.getUserInfo のデータ検証など:

インターフェイスによって返される rawData:

​

ユーザーのセッションキー:

HyVFkGl5F5OQWJZZaNzBBg==

したがって、署名に使用される文字列は次のようになります。

​

sha1 を使用して得られた結果は次のとおりです。

75e81ceda165f4ffa64f4068af58c64b8f54b88c

暗号化されたデータの復号化アルゴリズム

インターフェイスに機密データ (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

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