获取、传输微信开放数据
[[toc]]
#
概述微信开放了一系列的前端接口用于获取微信的开放数据,考虑到开发者服务端也需要获取这些开放数据,微信提供了两种获取方式:
- 传统方案:开发者后台校验与解密开放数据
- 云开发:云调用直接获取开放数据
本文将介绍第二种方式。
参考:服务端获取开放数据。
#
方案对比:传统方案 vs 云开发#
代码示例获取开放数据的接口,如果涉及到敏感数据(如 wx.getWeRunData()
),接口的明文内容将不包含这些敏感数据,而是在返回的接口中包含对应敏感数据的 cloudID
字段,数据可以通过云函数获取。完整流程如下:
#
第一步:获取 cloudID使用 2.7.0 或以上版本的基础库,如果小程序已开通云开发,在开放数据接口的返回值中可以通过 cloudID
字段获取(与 encryptedData
同级),cloudID
有效期五分钟。
以获取用户微信运动步数为例:
wx.getWeRunData({ success(res) { const cloudID = res.cloudID; // ... }});
#
第二步:调用云函数调用云函数时,对传入的 data
参数,如果有顶层字段的值为通过 wx.cloud.CloudID
构造的 cloudID
,则调用云函数时,这些字段的值会被替换为 cloudID
对应的开放数据,一次调用最多可替换 5 个 cloudID
。
示例:
在小程序获取到 cloudID
之后发起调用:
wx.getWeRunData({ success(res) { const id = res.cloudID; wx.cloud.callFunction({ name: "myFunction", data: { weRunData: wx.cloud.CloudID(id), // 这个 CloudID 值到云函数端会被替换, obj: { shareInfo: wx.cloud.CloudID("yyy") // 非顶层 CloudID,不会被替换 } } }); }});
在云函数收到的 event
示例:
// event{ // weRunData 的值已被替换为开放数据 "weRunData": { "cloudID": "xxx", "data": { "stepInfoList": [ { "step": 5000, "timestamp": 1554814312 } ], "watermark": { "appid": "wx1111111111", "timestamp": 1554815786 } } }, "obj": { // 非顶层字段维持原样 "shareInfo": "yyy" }}
如果 cloudID
非法或过期,则在 event
中获取得到的将是一个有包含错误码、错误信息和原始 cloudID
的对象。过期 cloudID
换取结果示例:
// event{ "weRunData": { "cloudID": "xxx", "errCode": -601006, "errMsg": "cloudID expired." } // ...}