微信 JS-SDK 开发

2018/04/23 17:06
阅读数 10

前言:微信几乎存在每台移动设备上,是一个不可忽视的流量入口,微信js-sdk的出现,让广大开发者可以调用微信原生功能,在微信上开发自己的应用。但是配置微信js-sdk开发环境对于前端初学者或者不太熟悉后台开发的开发者来说,是比较麻烦的,你需要获取签名,首先需要获取jsspi_ticket,获取jsspi_ticket,你又需要获取access_token,然而jsspi_ticket和access_token都是2小时内有效的,过期需要重新获取,你也不能频繁得获取,会出发频率限制导致不可用。除此之外,你还需要有一个安全域名,配置到公众号后台。

————————————————————————————————————

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

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

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

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

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

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

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

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

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

整个配置如下:

 

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


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

 

接下来我们具体看之:

 

 

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 方式的获取即可,

 

[plain]  view plain  copy
 
  1. https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET  

 

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

正确返回是这个样儿的,

 

[plain]  view plain  copy
 
  1. {"access_token":"ACCESS_TOKEN","expires_in":7200}  


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

 

 

[html]  view plain  copy
 
  1. {"errcode":40013,"errmsg":"invalid appid"}  

 

 

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

jsapi_ticket 目前也就不是问题了:

也只需 GET 方式即可,

 

[plain]  view plain  copy
 
  1. https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi  

 

 

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

正确的是这个样儿的,

 

[plain]  view plain  copy
 
  1. {  
  2.     "errcode":0,  
  3.     "errmsg":"ok",  
  4.     "ticket":"bxLdikRXVbTPdHSM05e5u5sUoXNKd8-41ZO3MhKoyN5OfkWITDGgnr2fwJ0m9E8NYzWKVZvdVtaUgWvsdshFKA",  
  5.     "expires_in":7200  
  6. }  


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

 

好,接下来咱就上 签名算法 了:

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

先拼成这样儿就好了,

 

[plain]  view plain  copy
 
  1. 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 了。

打完手工。。

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

 

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

咱的表结构,

 

[sql]  view plain  copy
 
  1. CREATE TABLE `CRM_APP_WECHAT` (  
  2.     `id` int(11) NOT NULL AUTO_INCREMENT,  
  3.     `eId` int(11) NOT NULL,  
  4.     `token` varchar(100) NOT NULL,  
  5.     `app_id` varchar(100) NOT NULL COMMENT '应用id',  
  6.     `app_secret` varchar(100) NOT NULL COMMENT '应用密钥',  
  7.     `access_token` varchar(200) NOT NULL,  
  8.     `jsapi_ticket` varchar(200) NOT NULL,  
  9.     `get_time_access_token` timestamp NULL DEFAULT NULL COMMENT '更新 access_token 时间',  
  10.     `expires_in_access_token` int(11) NOT NULL DEFAULT '7200' COMMENT 'access_token 失效时间',  
  11.     `get_time_jsapi_ticket` timestamp NULL DEFAULT NULL COMMENT '获取 jsapi_ticket 时间',  
  12.     `expires_in_jsapi_ticket` int(11) NOT NULL DEFAULT '7200' COMMENT 'jsapi_ticket 失效时间',  
  13.     `create_user` int(11) NOT NULL DEFAULT '-1',  
  14.     `create_time` timestamp NULL DEFAULT NULL,  
  15.     `modify_user` int(11) NOT NULL DEFAULT '-1',  
  16.     `modify_time` timestamp NULL DEFAULT NULL,  
  17.     PRIMARY KEY (`id`)  
  18. ) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8 COMMENT='微信敏感信息记录表';  

 

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

展开阅读全文
打赏
0
0 收藏
分享
加载中
更多评论
打赏
0 评论
0 收藏
0
分享
在线直播报名
返回顶部
顶部