JSSDK使用步骤
先登录微信公众平台进入“公众号设置”的“功能设置”里填写“JS接口安全域名”。
备注:登录后可在“开发者中心”查看对应的接口权限。
在需要调用JS接口的页面引入如下JS文件,(支持https):http://res.wx.qq.com/open/js/jweixin-1.2.0.js
备注:支持使用 AMD/CMD 标准模块加载方法加载
所有需要使用JS-SDK的页面必须先注入配置信息,否则将无法调用(同一个url仅需调用一次,对于变化url的SPA的web app可在每次url变化时进行调用,目前Android微信客户端不支持pushState的H5新特性,所以使用pushState来实现web app的页面会导致签名失败,此问题会在Android6.2中修复)。
wx.config({
debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
appId: '', // 必填,公众号的唯一标识
timestamp: , // 必填,生成签名的时间戳
nonceStr: '', // 必填,生成签名的随机串
signature: '',// 必填,签名,见附录1
jsApiList: [] // 必填,需要使用的JS接口列表
});
wx.ready(function(){
// config信息验证后会执行ready方法,所有接口调用都必须在config接口获得结果之后,config是一个客户端的异步操作,所以如果需要在页面加载时就调用相关接口,则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中。
});
wx.error(function(res){
// config信息验证失败会执行error函数,如签名过期导致验证失败,具体错误信息可以打开config的debug模式查看,也可以在返回的res参数中查看,对于SPA可以在这里更新签名。
});
JS-SDK使用权限签名算法
jsapi_ticket
生成签名之前必须先了解一下jsapi_ticket,jsapi_ticket是公众号用于调用微信JS接口的临时票据。正常情况下,jsapi_ticket的有效期为7200秒,通过access_token来获取。由于获取jsapi_ticket的api调用次数非常有限,频繁刷新jsapi_ticket会导致api调用受限,影响自身业务,开发者必须在自己的服务全局缓存jsapi_ticket 。
1.参考以下文档获取access_token(有效期7200秒,开发者必须在自己的服务全局缓存access_token)获取access_token地址
https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140183
2.用第一步拿到的access_token 采用http GET方式请求获得jsapi_ticket(有效期7200秒,开发者必须在自己的服务全局缓存jsapi_ticket):https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi
成功返回如下JSON:
{
"errcode":0,
"errmsg":"ok",
"ticket":"bxLdikRXVbTPdHSM05e5u5sUoXNKd8-41ZO3MhKoyN5OfkWITDGgnr2fwJ0m9E8NYzWKVZvdVtaUgWvsdshFKA",
"expires_in":7200
}
获得jsapi_ticket之后,就可以生成JS-SDK权限验证的签名了
获取ticket方法
@Overridepublic boolean refreshTicket(String token) {boolean flag = true;MapparamMap = new HashMap();
paramMap.put("access_token", token);
paramMap.put("type", "jsapi");
try {
JSONObject ret = getHttpClient().get(ticketUrl, paramMap);
if (null != ret) {
String ticket = ret.getString("ticket");
log.info("refreshTicket ticket {}", ticket);
if (StringUtils.isNotBlank(ticket)) {
redisManager.set(ticketKey, ticket);
}
}
} catch(Exception e) {
log.error("json conversion error or refreshTicket error .", e);
return false;
}
return flag;
}
分享到朋友圈,js实现参考微信API
@RequestMapping("/weixinShare")@ResponseBody
public BaseAPIResonseVO weixinShare(@RequestParam("currentUrl") String currentUrl,HttpServletRequest request){
BaseAPIResonseVO vo = new BaseAPIResonseVO();try {MapreturnMap = new HashMap(); Properties properties = PropertiesUtil.getProperties("weixin.properties"); String appid = properties.get("weixin_appid").toString(); returnMap.put("appId",appid); returnMap.put("timeStamp", System.currentTimeMillis()/1000+""); returnMap.put("nonceStr", randomString(32)); MapsignMap = SignUtils.sign(wsWeixinTokenService.getTicket(),currentUrl,returnMap.get("nonceStr").toString(),returnMap.get("timeStamp").toString());
returnMap.put("signature", signMap.get("signature"));
log.info("weixin weixinShare param" + returnMap.toString());
AuthToken authToken = getUserSessionInfo(request);
if(null == authToken){
log.warn("分享到朋友圈未获得用户的邀请码!");
}else{
returnMap.put("invitedCode", authToken.getInvitationCode());
}
vo.success(returnMap);
} catch (Exception e) {
log.error("系统繁忙,请稍后再试",e);
}
return vo;
}