1. 微信公众账号接口说明文档
https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433401084
1.1. 我这次查询,主要是想使用“微信JS-SDK说明文档”,好实现将网站的网页 分享到朋友圈 或 发送给彭友时,可以显示指定的缩略图 和 简介。
分别使用到三个文档:
1)js-sdk说明文档
https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421141115
2)授权后如何调用js-sdk
https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1421823488&token=&lang=zh_CN
3) 授权流程
https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1453779503&token=&lang=zh_CN
2. 微信开放平台
https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&lang=zh_CN
2.1.第三方平台
1)通过公众号或小程序管理员授权,无需写死AppSecret
到微信第三方开放平台注册账号,申请开发者资质认证,后可使用自动授权
https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419318292&token=&lang=zh_CN
或直接使用AppSecret获取access_token,但是不安全,也容易在AppSecret重置后失效
3. 微信 WeixinJSBridge API
https://www.cnblogs.com/txw1958/p/WeixinJSBridge-api.html
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
<!DOCTYPE html> <html> <head> <title>微信WeixinJSBridge API</title> <meta charset="utf-8" /> <script type="text/javascript"> (function(){ var a=document.getElementsByTagName("html")[0]; window.Session={appDomain:a.getAttribute("data-app-domain")||"",staticDomain:a.getAttribute("data-static-domain")||""} })(); window.registNS=function(fullNS,isIgnorSelf){ var reg=/^[_$a-z]+[_$a-z0-9]*/i;var nsArray=fullNS.split("."); var sEval=""; var sNS=""; var n=isIgnorSelf?nsArray.length-1:nsArray.length; for(var i=0;i<n;i++){ if(!reg.test(nsArray[i])){throw new Error("Invalid namespace:"+nsArray[i]+""); return } if(i!=0){sNS+="."} sNS+=nsArray[i]; sEval+="if(typeof("+sNS+")=='undefined') "+sNS+"=new Object(); else "+sNS+";" } if(sEval!=""){ return eval(sEval) } return{} }; </script> </head> <body> <section class="mod-page-body"> <div class="mod-page-main wordwrap clearfix"> <div class="mod-pageheader"></div> <div class="mod-pagecontent"> <div class="mod-weixinjsapi"> <div class="x-desc"> 微信客户端自带的Js Api:WeixinJSBridge </div> <div id="WeixinJsApi"> <input type="button" id="imagePreview" value="图片预览" /> <input type="button" id="profile" value="查看profile" /> <a href="weixin://profile/gh_412d74fbb474">企业微信小助手</a> <input type="button" id="shareWeibo" value="分享微博" /> <input type="button" id="shareFB" value="分享facebook" /> <input type="button" id="addContact" value="添加联系人" /> <input type="button" id="scanQRCode" value="扫描二维码" /> <input type="button" id="jumpToBizProfile" value="跳转到指定公众账号页面" /> <input type="button" id="toggleMenuBtn" value="隐藏右上角按钮" /> <input type="button" id="toggleToolbar" value="隐藏底部导航栏" /> <input type="button" id="getNetType" value="获取网络状态" /> <input type="button" id="closeWindow" value="关闭" /> <input type="button" id="getBrandWCPayRequest" value="发起公众号微信支付" /> <input type="button" id="setPageState" value="设置页面状态" /> <input type="button" id="sendEmail" value="发邮件" /> <input type="button" id="openSpecificView" value="微信团队打开webView,跳到指定页面" /> <input type="button" id="getCanIAPPay" value="getCanIAPPay" /> <input type="button" id="getBrandIAPPayRequest" value="发起公众号IAP支付" /> <input type="button" id="openUrlByExtBrowser" value="用safari打开指定链接" /> <input type="button" id="openProductView" value="跳转微信商品页" /> <input type="button" id="openLocation" value="查看地理位置" /> <input type="button" id="timelineCheckIn" value="朋友圈签到" /> <input type="button" id="getBrandWCPayCreateCreditCardRequest" value="开通微信信用卡" /> <input type="button" id="geoLocation" value="获取地理位置" /> <input type="button" id="getInstallState" value="获取某app是否安装" /> <input type="button" id="editAddress" value="公众号编辑收货地址" /> <input type="button" id="getLatestAddress" value="公众号获取最近的收货地址" /> <input type="button" id="launch3rdApp" value="启动第三方APP" /> <input type="button" id="jumpWCMall" value="跳转微信商品购买界面" /> <input type="button" id="addEmoticon" value="添加表情" /> <input type="button" id="cancelAddEmoticon" value="取消下载某表情" /> <input type="button" id="hasEmoticon" value="查询是否存在某表情" /> </div> </div> </div> </div> </section> <script> function onBridgeReady() { WeixinJSBridge.on('menu:share:appmessage', function(argv) { WeixinJSBridge.invoke('sendAppMessage',{ "link":"http://m.exmail.qq.com/", "desc":"desc", "title":"title for WeiXinJsBridge" }, function(res) { WeixinJSBridge.log(res.err_msg); }); }); WeixinJSBridge.on('menu:share:timeline', function(argv) { WeixinJSBridge.invoke("shareTimeline",{ "link":"http://m.exmail.qq.com", "img_url":"http://rescdn.qqmail.com/bizmail/zh_CN/htmledition/images/bizmail/v3/logo1ca3fe.png", "img_width":"172", "img_height":"40", "desc":"i am description", "title":"just test from WeixinJsBridge" }, function(e){ alert(e.err_msg); }) }); } if (typeof WeixinJSBridge === "undefined"){ if (document.addEventListener){ document.addEventListener('WeixinJSBridgeReady', onBridgeReady, false); } }else{ onBridgeReady(); } var menuHidden=!1,toolbarHidden=!1,netType={"network_type:wifi":"wifi网络","network_type:edge":"非wifi,包含3G/2G","network_type:fail":"网络断开连接","network_type:wwan":"2g或者3g"}; document.addEventListener("WeixinJSBridgeReady",function(){ document.getElementById("imagePreview").addEventListener( "click",function(){ WeixinJSBridge.invoke("imagePreview",{ "urls":[ "http://rescdn.qqmail.com/bizmail/zh_CN/htmledition/images/bizmail/v3/logo1ca3fe.png", "http://rescdn.qqmail.com/bizmail/zh_CN/htmledition/images/bizmail/v3/icons_features1ca3fe.png", "http://rescdn.qqmail.com/bizmail/zh_CN/htmledition/images/bizmail/v3/icons_workStyle1ca3fe.png" ], "current":"http://rescdn.qqmail.com/bizmail/zh_CN/htmledition/images/bizmail/v3/icons_features1ca3fe.png" }) },!1), document.getElementById("profile").addEventListener( "click",function(){ alert("profile clicked"); WeixinJSBridge.invoke("profile",{ "username":"gh_412d74fbb474", "nickname":"企业微信小助手" }) },!1), document.getElementById("shareWeibo").addEventListener( "click",function(){ WeixinJSBridge.invoke("shareWeibo",{ "type":"link", "link":"http://m.exmail.qq.com" }, function(e){ alert(e.err_msg); }) },!1), document.getElementById("shareFB").addEventListener( "click",function(){ WeixinJSBridge.invoke("shareFB",{ "link":"http://m.exmail.qq.com" }) },!1), document.getElementById("scanQRCode").addEventListener( "click",function(){ WeixinJSBridge.invoke("scanQRCode",{ }) },!1), document.getElementById("addEmoticon").addEventListener( "click",function(){ WeixinJSBridge.invoke("addEmoticon",{ "url":"http://rescdn.qqmail.com/bizmail/zh_CN/htmledition/images/bizmail/v3/icons_features1ca3fe.png", "thumb_url":"http://rescdn.qqmail.com/bizmail/zh_CN/htmledition/images/bizmail/v3/logo1ca3fe.png" }, function(e){ alert(e.err_msg); }) },!1), document.getElementById("cancelAddEmoticon").addEventListener( "click",function(){ WeixinJSBridge.invoke("cancelAddEmoticon",{ "url":"http://rescdn.qqmail.com/bizmail/zh_CN/htmledition/images/bizmail/v3/icons_features1ca3fe.png" }, function(e){ alert(e.err_msg); }) },!1), document.getElementById("hasEmoticon").addEventListener( "click",function(){ WeixinJSBridge.invoke("hasEmoticon",{ "url":"http://rescdn.qqmail.com/bizmail/zh_CN/htmledition/images/bizmail/v3/icons_features1ca3fe.png" }, function(e){ alert(e.err_msg); }) },!1), document.getElementById("addContact").addEventListener( "click",function(){ WeixinJSBridge.invoke("addContact",{ "webtype":"1", "username":"gh_412d74fbb474" }, function(e){ alert(e.err_msg); }) },!1), document.getElementById("jumpToBizProfile").addEventListener( "click",function(){ WeixinJSBridge.invoke("jumpToBizProfile",{ "tousername":"gh_2248a2ade13e" }, function(e){ alert(e.err_msg); }) },!1), document.getElementById("toggleMenuBtn").addEventListener( "click",function(){ menuHidden? (WeixinJSBridge.call("showOptionMenu"),menuHidden=!1,this.value="隐藏右上角按钮") : (WeixinJSBridge.call("hideOptionMenu"),menuHidden=!0,this.value="显示右上角按钮") },!1), document.getElementById("toggleToolbar").addEventListener( "click",function(){ toolbarHidden? (WeixinJSBridge.call("showToolbar"),toolbarHidden=!1,this.value="隐藏底部导航栏") : (WeixinJSBridge.call("hideToolbar"),toolbarHidden=!0,this.value="显示底部导航栏") },!1), document.getElementById("getNetType").addEventListener( "click",function(){ WeixinJSBridge.invoke("getNetworkType",{}, function(e){ alert(netType[e.err_msg]) }) },!1), document.getElementById("closeWindow").addEventListener( "click",function(){ WeixinJSBridge.invoke("closeWindow",{},function(e){}) },!1), document.getElementById("getBrandWCPayRequest").addEventListener( "click",function(){ WeixinJSBridge.invoke("getBrandWCPayRequest",{ "appId" : "wxf8b4f85f3a794e77", //公众号名称,由商户传入 "timeStamp" : "189026618", //时间戳 这里随意使用了一个值 "nonceStr" : "adssdasssd13d", //随机串 "package" : "body=xxx&fee_type=1&input_charset=GBK¬ify_url=http&out_trade_no=16642817866003386000&partner=1900000109&return_url=http&spbill_create_ip=127.0.0.1&total_fee=1&sign=273B7EEEE642A8E41F27213D8517E0E4", //扩展字段,由商户传入 "signType" : "SHA1", //微信签名方式:sha1 "paySign" : "b737015b5b1eabe5db580945a07eac08c7bb55f8" //微信签名 }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("setPageState").addEventListener( "click",function(){ WeixinJSBridge.invoke("setPageState",{ "state" : "1" }) },!1), document.getElementById("sendEmail").addEventListener( "click",function(){ WeixinJSBridge.invoke("sendEmail",{ "title" : "title!", "content" : "i am an Email!", //时间戳 这里随意使用了一个值 }, function(e){ // alert(e.err_msg) }) },!1), document.getElementById("openSpecificView").addEventListener( "click",function(){ WeixinJSBridge.invoke("openSpecificView",{ "specificview" : "contacts" }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("getCanIAPPay").addEventListener( "click",function(){ WeixinJSBridge.invoke("getCanIAPPay",{ }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("getBrandIAPPayRequest").addEventListener( "click",function(){ WeixinJSBridge.invoke("getBrandIAPPayRequest",{ "appId" : "wxf8b4f85f3a794e77", //公众号名称,由商户传入 "timeStamp" : "189026618", //时间戳 这里随意使用了一个值 "nonceStr" : "adssdasssd13d", //随机串 "package" : "bankType=CITIC_CREDIT&bankName=%e4%b8%ad%e4%bf%a1%e9%93%b6%e8%a1%8c&sign=CF8922F49431FFE8A1834D0B32B25CE3", //扩展字段,由商户传入 "signType" : "SHA1", //微信签名方式:sha1 "paySign" : "1e6f13f78ca0ec43fbb80899087f77568af66987" //微信签名 }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("openLocation").addEventListener( "click",function(){ WeixinJSBridge.invoke("openProductView",{ "latitude" : 23.113, //纬度 "longitude" : 113.23, //经度 "name" : "TIT创意园", //POI名称 "address" : "广州市海珠区新港中路397号", //地址 "scale" : 14, //地图缩放级别 "infoUrl" : "http://weixin.qq.com/", //查看位置界面底部的超链接 }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("timelineCheckIn").addEventListener( "click",function(){ WeixinJSBridge.invoke("timelineCheckIn",{ "img_url": "http://mmsns.qpic.cn/mmsns/RLllkTm3DUdV24xbZnKicx9jJWxXI0Bq84zzbtibGuRyk/0", // 分享到朋友圈的缩略图 "img_width": "640", // 图片的长度 "img_height": "640", // 图片高度 "link": "http://news.qq.com/zt2012/cxkyym/index.htm", // 连接地址 "desc": "这个是描述啊啊", // 描述 "title": "朝鲜称中国渔船越界捕捞", // 分享标题 "latitude" : 23.113, //纬度 "longitude" : 113.23, //经度 "poiId" : "dianping_2331037", //商户id "poiName" : "TIT创意园", //POI名称 "poiAddress" : "广州市海珠区新港中路397号", //地址 "poiScale" : 14, //地图缩放级别 "poiInfoUrl" : "http://weixin.qq.com/" //查看位置界面底部的超链接 }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("geoLocation").addEventListener( "click",function(){ WeixinJSBridge.invoke("geoLocation",{ }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("getBrandWCPayCreateCreditCardRequest").addEventListener( "click",function(){ WeixinJSBridge.invoke("getBrandWCPayCreateCreditCardRequest",{ "appId" : "wxf8b4f85f3a794e77", //公众号名称,由商户传入 "timeStamp" : "189026618", //时间戳 这里随意使用了一个值 "nonceStr" : "adssdasssd13d", //随机串 "package" : "bankType=CITIC_CREDIT&bankName=%e4%b8%ad%e4%bf%a1%e9%93%b6%e8%a1%8c&sign= CF8922F49431FFE8A1834D0B32B25CE3", //扩展字段,由商户传入 "signType" : "SHA1", //微信签名方式:sha1 "paySign" : "1e6f13f78ca0ec43fbb80899087f77568af66987" //微信签名 }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("getInstallState").addEventListener( "click",function(){ WeixinJSBridge.invoke("getInstallState",{ "packageUrl":"teamcircle://" }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("openProductView").addEventListener( "click",function(){ WeixinJSBridge.invoke("openProductView",{ "productInfo":"json" }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("getLatestAddress").addEventListener( "click",function(){ WeixinJSBridge.invoke("getLatestAddress",{ "appId" : "wxf8b4f85f3a794e77", //公众号名称,由商户传入 "timeStamp" : "189026618", //时间戳 这里随意使用了一个值 "nonceStr" : "adssdasssd13d", //随机串 "signType" : "SHA1", //微信签名方式:sha1 "addrSign" : "b737015b5b1eabe5db580945a07eac08c7bb55f8", //微信签名 "scope" : "snsapi" }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("editAddress").addEventListener( "click",function(){ WeixinJSBridge.invoke("editAddress",{ "appId" : "wxf8b4f85f3a794e77", //公众号名称,由商户传入 "timeStamp" : "189026618", //时间戳 这里随意使用了一个值 "nonceStr" : "adssdasssd13d", //随机串 "signType" : "SHA1", //微信签名方式:sha1 "addrSign" : "b737015b5b1eabe5db580945a07eac08c7bb55f8", //微信签名 "scope" : "snsapi" }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("launch3rdApp").addEventListener( "click",function(){ WeixinJSBridge.invoke("launch3rdApp",{ "appId" : "wx5823bf96d3bd56c7", //公众号名称,由商户传入 }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("jumpWCMall").addEventListener( "click",function(){ WeixinJSBridge.invoke("jumpWCMall",{ "appId" : "wx5823bf96d3bd56c7", //公众号名称,由商户传入 "funcId":"1000" }, function(e){ alert(e.err_msg) }) },!1), document.getElementById("openUrlByExtBrowser").addEventListener( "click",function(){ WeixinJSBridge.invoke("openUrlByExtBrowser",{ "url" : "http://m.exmail.qq.com" }, function(e){ alert(e.err_msg) }) },!1) } ); </script> </body> </html>
4. 遇到的问题记录
4.1 手机微信端获取授权code的时候,微信服务器重点向了两次问题
这问题有人提过,不过后面不了了之,所以我再提一次
解决方案
-
加 &connect_redirect=1 即:https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE&connect_redirect=1#wechat_redirect 这种做法测试过,微信服务器确实是只重定向了一次,不过也有人说有些手机加了这参数还不行。那么问题来了,这个参数在微信官方的开发文档中并未提及,而且微信接口是有做正则判断的,顺序稍错就不能通过,但很明显,这么加是能通过的,说明微信这API是有这个参数的,但没写到文档上,我不知道是文档没及时更新还是其他什么原因。
-
使用中间页面跳转
第一步先在后台拼接 open.weixin.qq.com的授权url,返回到中间页面,显示“正在登录”;第二部,使用window.location.href = auth_url,自动跳转
4.2 微信分享接口问题
项目中使用的url采用的是单应用网站的格式,即带#的hash参数为子页面链接
例如:http://test.com/#!/detail.hx?uuid=ba5d0408-42b9-4e0a-8a03-5e3891f52298
在wx.ready中编写分享接口时,link参数直接放置这个url,分享出去的页面,点击无法进入详情页,直接进入首页
原因:微信默认自动去除了#之后的字符串
解决方案:wx.ready中配置接口link时,应添加“from=singlemessage”的参数
例如:http://test.com/?from=singlemessage#!/detail.hx?uuid=ba5d0408-42b9-4e0a-8a03-5e3891f52298
var prefix = window.location.href.split(splitChar)[0]; if(prefix.indexOf(wxShareKeyword) <= 0){ prefix = prefix + "?" + wxShareKeyword; } // log("prefix:" + prefix); var last = window.location.href.split(splitChar)[1]; // log("last:" + last); var requestUrl = prefix + splitChar + last;
4.2 调起微信公众号关注界面,然后跳回到原页面
没有找到,可以直接打开关注界面,然后跳转的方案
替代方案: 发现用户未关注,则打开关注公众号的二维码,用户扫描打开关注公众号后,在公众号对话界面主动推送一个链接,可以点击跳转到原页面
使用的接口:1)账号管理-》生成带参数的二维码;2)消息管理--》接收事件推送
5. 在线Debug工具
原文:http://ngdemo.sinaapp.com/debug/?hash=test
在线Debug工具
本工具为了解决移动端console日志无法查看的难题,只需要一个js文件即可在本页面实时查看console日志!
Js文件地址:http://ngdemo.sinaapp.com/library/debug?hash=debug 请把debug改成你自己的参数
使用方法
- 在需要调试的页面写入 <script src="http://ngdemo.sinaapp.com/library/debug?hash=debug"></script>
- 打开本页面,下方即可实时查看JS日志
源代码如下:
var socket = new WebSocket("ws://localhost:18080"); var connected = false; window.console.log = function(o) { o =typeof o == "object"?JSON.stringify(o):o; var timer = setInterval(function(){ if(connected){ timer && clearInterval(timer); socket.send(JSON.stringify({hash:"debug",msg:o,type:"msg"})); } },100); } socket.onopen = function(e){ connected = true; console.log("[110.87.105.11] "+navigator.appVersion+" connected."); }; socket.onclose = function(e){ connected = false; }; socket.onmessage = function(e){ }; window.onerror = function (err, url, line) { if(connected){ socket.send(JSON.stringify({hash:"debug",error:err,url:url,line:line,type:"error"})); } return true; };