首页 > 代码库 > 微信 JS-SDK 开发

微信 JS-SDK 开发

2024-11-17 15:58:02   203人阅读

脱离了煎熬的等待之后，微信给出了微信JS-SDK说明文档 的开发文档，着实给咱们带了便利啊。

话不多说，跟着文档咱做起开发来。

其实在文档中说的是比较明白的了，我呢只是将自己处理的方法贴出来，一是让大家参考，二是咱也不是什么大神，如有问题还望各位不吝指教哦。

根据文档说明，咱们总共需要做至少五个步骤的事情：

步骤一：绑定域名
步骤二：引入JS文件
步骤三：通过config接口注入权限验证配置
步骤四：通过ready接口处理成功验证
步骤五：通过error接口处理失败验证

接下来咱就按部就班的搞起。

对了，关于下面的所有操作都是要在后台进行的，js也可以单独获取/产生相应的数据，但是不安全，不方便。个人觉得后台操作高大上:)

步骤一、步骤二咱就不将了，直接点击上面的链接到微信文档就能轻松解决。

关键是对于第三步的处理，注入权限验证配置

整个配置如下：

wx.config({
    debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来，若要pc端打开时可以查看传入的参数，以log打出。
    appId: '', // 必填，公众号的唯一标识
    timestamp: , // 必填，生成签名的时间戳
    nonceStr: '', // 必填，生成签名的随机串
    signature: '',// 必填，签名，见附录1
    jsApiList: [] // 必填，需要使用的JS接口列表，所有JS接口列表见附录2
});

我们看到这里边一堆的参数，不过其实都是比较简单的进行设置即可，只不过也有存在一定的关联性。

接下来我们具体看之：


debug

这个就不多说了，一般在开发时都是 true，在这个模式下基本上执行的每个 js 调用都会给显示出来，不需要自己在写什么 alert 了，比较方便。不过真实使用时就算你不打算改成 false，也绝对会有人打电话给你让你改成 false :)

appId

在微信后台的开发者中心就能够直接看到，和 appSecret在一堆儿的。当然这个既可以 hard coding,也可以动态获取，如果此模块开发出来不是只给一个公众号使用。

timestamp/nonceStr/signature

这三个东东就要我们自己来弄了，这个在下文着重介绍了。总之呢，timestamp/nonceStr 是由我们自己生成的，然后再参与到 signature 的生成中。

jsApiList

列出当前页面中咱要使用到的JS接口，可点击上文链接的附录2查看。


好，接下来就是关键部分咯(对于权限签名算法的原版介绍请点击上文链接的附录1进行查看)


一个完整的链条如下图所示：

appId/appSecret  --->  access_token --->  jsapi_ticket  ---->  signature  --->  config 配置


其中对于 access_token/jsapi_ticket 由于访问数量的限制(貌似是1000,可自行查看)，需要进行相应的缓存处理，而每次获取后的有效时间目前为 7200s。


好，咱们可以继续接下来的步骤了。

我们来获取 access_token 吧(点咱看官版介绍)：

只需要采用 GET 方式的获取即可，

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

只需要将上述 APPID/APPSECRET 替换为咱自个儿的就行，就像上文所说如果是做多个公众号的配置，肯定是要做相应的动态处理的，下文或有所介绍。

正确返回是这个样儿的，

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

错误的大概是这个样儿的，

{"errcode":40013,"errmsg":"invalid appid"}


可能还有其它的错误哦。。

jsapi_ticket 目前也就不是问题了：

也只需 GET 方式即可，

https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi


将其中的 ACCESS_TOKEN 替换为自个儿的就行。

正确的是这个样儿的，

{
    "errcode":0,
    "errmsg":"ok",
    "ticket":"bxLdikRXVbTPdHSM05e5u5sUoXNKd8-41ZO3MhKoyN5OfkWITDGgnr2fwJ0m9E8NYzWKVZvdVtaUgWvsdshFKA",
    "expires_in":7200
}

额，官方没说错误是啥样儿的(咱也没碰到。。)

好，接下来咱就上 签名算法 了：

其实官方说了一堆儿，就是这个样子的，

先拼成这样儿就好了，

jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg&noncestr=Wm3WZYTPz0wzccnW&timestamp=1414587457&url=http://mp.weixin.qq.com

然后，在这个字符串中 key 相对位置是固定的，且全是小谢的， noncestr/timestamp 也就是咱们自己生成的，这俩也会放到界面上的 config 参数中。然后对于最后的 url 值的定义是：当前持有 config 配置页面的完整 url 链接，不过不包含 # 号及其后边的字符串，且不要做任何的URL转义。

完了我们就将生成的串儿用 sha1 进行加密，ok， 就得到咱们要的 signature 了。

打完手工。。

对的，不过关于咱真正的处理方式其实还没有讲哟。。


关于那俩特娇气的 东西咱还的做缓存不是，于是我就把它俩扔数据库去了：

咱的表结构，

CREATE TABLE `CRM_APP_WECHAT` (
    `id` int(11) NOT NULL AUTO_INCREMENT,
    `eId` int(11) NOT NULL,
    `token` varchar(100) NOT NULL,
    `app_id` varchar(100) NOT NULL COMMENT '应用id',
    `app_secret` varchar(100) NOT NULL COMMENT '应用密钥',
    `access_token` varchar(200) NOT NULL,
    `jsapi_ticket` varchar(200) NOT NULL,
    `get_time_access_token` timestamp NULL DEFAULT NULL COMMENT '更新 access_token 时间',
    `expires_in_access_token` int(11) NOT NULL DEFAULT '7200' COMMENT 'access_token 失效时间',
    `get_time_jsapi_ticket` timestamp NULL DEFAULT NULL COMMENT '获取 jsapi_ticket 时间',
    `expires_in_jsapi_ticket` int(11) NOT NULL DEFAULT '7200' COMMENT 'jsapi_ticket 失效时间',
    `create_user` int(11) NOT NULL DEFAULT '-1',
    `create_time` timestamp NULL DEFAULT NULL,
    `modify_user` int(11) NOT NULL DEFAULT '-1',
    `modify_time` timestamp NULL DEFAULT NULL,
    PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8 COMMENT='微信敏感信息记录表';

处理逻辑大概如下(自顶向下)：

技术分享

微信 JS-SDK 开发


联系
我们