【微信开发】初次接触微信公众号开发,相关资料记录

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

<!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&notify_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>
View Code

4. 遇到的问题记录

4.1 手机微信端获取授权code的时候,微信服务器重点向了两次问题

  这问题有人提过,不过后面不了了之,所以我再提一次

  解决方案

  1. 加 &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是有这个参数的,但没写到文档上,我不知道是文档没及时更新还是其他什么原因。

  2. 使用中间页面跳转

    第一步先在后台拼接 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改成你自己的参数

使用方法

  1. 在需要调试的页面写入 <script src="http://ngdemo.sinaapp.com/library/debug?hash=debug"></script>
  2. 打开本页面,下方即可实时查看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; };
原文地址:https://www.cnblogs.com/yingsong/p/8266841.html