微信公众号对接第三方平台开发


前言

        微信公众号对接第三方开发的前提就是授权。首先是开通开放平台。开通时填写资料包括公司信息,还需要300大洋。开放平台包括移动应用、网站应用、公众号账号、小程序、第三方平台。这里我们开通第三方平台。

         开通第三方平台时填写基本信息,比如平台名称、平台介绍、平台图片。下一步是选择权限集、开发资料。权限集就是托管公众号的功能、比如回复消息、创建菜单、会话管理等等。  开发资料这里有3个地方需要注意,授权事件接收url、授权测试公众号列表、公众号消息于事件接收url。  授权测试公众号列表主要是在全网发布之前,在列表内的公众号才能进行授权。

一键授权给第三方平台

       先来看一下官方提供的流程图,有一个直观的认识。

       

      授权官方提供了两种方式,授权注册页面扫码授权、点击移动端链接快速授权。这里我用的是第一种,在自己的页面上放一个链接,点击后会生成一个二维码让公众号管理员扫码授权。 https://mp.weixin.qq.com/cgi-bin/componentloginpage?component\_appid=xxxx&pre\_auth\_code=xxxxx&redirect\_uri=xxxx&auth\_type=xxx。 

       这里看到了链接路径包括包括4个参数。前3个是必填。component_appid是第三方平台的appid、redirect_uri是你需要用来获取授权信息的url。同意授权后微信服务器会请求这给地址。 到这里绕了一圈还有一个参数pre_auth_code。 这个参数怎么获取?这里先看一下官方文档 https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1453779503&token=&lang=zh_CN  。 这里就该使用创建第三方平台时填写的授权事件url了。微信服务器会每隔10分钟向改地址发起请求,接收到的消息是密文,需要自己解密,官方已经提供了demo,可以参考。pre_auth_code就要从这里的密文消息中获取。

        用下面这个示意图来消化一下。分3步来获取预授权码

获取component_verify_ticket

获取component_access_token

      这里注意一下,获取component_access_token参数是JSON字符串,在对接第三方平台开发时这两个参数至关重要。component_verify_ticket是公众平台和第三方平台沟通的桥梁。这两个参数可以根据自己的需要保存在数据库或者redis里。后续调用其他高级接口和网页授权时都需要用到。    

   获取预授权码(pre_auth_code)

     知道了具体获取的方法,那我们就看下具体的处理方法,第一步先获取verify_ticket。

 string sToken = "第三方平台token";
 string sAppID = "第三方平台appid";
 string sEncodingAESKey = "第三方平台aeskey";

WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(sToken, sEncodingAESKey, sAppID);

        
if (Request.HttpMethod.ToLower() == "post")
{
	string sig = Request.QueryString["msg_signature"];
	string timestamp = Request.QueryString["timestamp"];
	string nonce = Request.QueryString["nonce"];
	StreamReader sr = new StreamReader(Request.InputStream, Encoding.UTF8);
	string respData = sr.ReadToEnd();

	string sMsg = "";  //解析之后的明文
	int ret = 0;
	ret = wxcpt.DecryptMsg(sig, timestamp, nonce, respData, ref sMsg);

	if (ret != 0)
	{
		return;
	}

	XmlDocument doc = new XmlDocument();
	doc.LoadXml(sMsg);

	string infotype = doc.SelectSingleNode("xml").SelectSingleNode("InfoType").InnerText;
	string componentVerifyTicket = doc.SelectSingleNode("xml").SelectSingleNode("ComponentVerifyTicket").InnerText;

	switch (infotype)
	{
		case "component_verify_ticket":

			LogHelper.Info("ticket:" + componentVerifyTicket);//这里就拿到了component_verify_ticket
			
			Response.Write("success");
			Response.End();
			break;
		case "unauthorized"://用户取消授权
			Response.End();
			break;
		
	}

}

  第二步获取componet_access_token

private static ResponseComponentToken GetComponentToken(string appid,string appsecret,string verifyticket)
    {
        
        var urlFormat = "https://api.weixin.qq.com/cgi-bin/component/api_component_token";
        object data = null;
        data = new
        {
            component_appid = appid,
            component_appsecret = appsecret,
            component_verify_ticket = verifyticket
        };


        return CommonJsonSend.Send("", urlFormat, data);
    }

  OK。这里pre_auth_code就不罗列了,可以用程序调,也可以用postman调用。

       到这里,拿到pre_auth_code就可以点击上面的授权地址生成二维码,扫码。授权结束。有点费劲!!!

代公众号网页授权

     对接第三方平台后,网页授权还是分为两种方式,静默方式只能拿到openid、需要用户授权的可以拿到更多的用户信息。实现方式相比公众号略有不同:

  这里做开发时我用senparc SDK, 参数包括公众号appid、第三方平台appid、第三方平台accesstoken。

OAuthAccessTokenResult result = OAuthApi.GetAccessToken(appid, compAppid, compAccessToken, code);

代公众号处理消息和事件

       创建第三方平台时填写了消息和事件接收url。第三方平台会把用户和微信互动的消息和事件转发到次url。也就是在这里你可以处理具体的消息和事件,比如关注、取消关注、发送文本消息、图片消息。 这里和公众号处理消息不同的地方在于回复用户的消息全部要加密。加密方式同verify_ticket获取。  

        这里不需要再自己封装互动的消息和事件。直接用senparcSDK的CustomerMessageHandler处理即可。 最后回复用户消息时需要用到加密消息:FinalResponseDocument。可以参考senparcSDK demo。

 if (Request.HttpMethod.ToLower() == "post")
        {

            var postModel = new PostModel()
            {
                Signature = Request.QueryString["signature"],
                Msg_Signature = Request.QueryString["msg_signature"],
                Timestamp = Request.QueryString["timestamp"],
                Nonce = Request.QueryString["nonce"],
                EncodingAESKey = sEncodingAESKey,
                Token = sToken,
                AppId = sAppID
            };


            var maxRecordCount = 10;
            var messageHandler = new CustomMessageHandler(Request.InputStream, postModel, maxRecordCount);

            try
            {
                
                //messageHandler.RequestDocument.Save(
                //    Server.MapPath("~/App_Data/" + DateTime.Now.Ticks + "_Request_" +
                //                   messageHandler.RequestMessage.FromUserName + ".txt"));

                messageHandler.Execute();//执行微信处理过程(关键)

                
                //messageHandler.ResponseDocument.Save(
                //    Server.MapPath("~/App_Data/" + DateTime.Now.Ticks + "_Response_" +
                //                   messageHandler.ResponseMessage.ToUserName + ".txt"));

                Response.Output.Write(messageHandler.FinalResponseDocument.ToString());
                //Response.Write("success");
                return;
            }
            catch (Exception ex)
            {
                LogHelper.Error(ex.Message,ex);
            }
            finally
            {
                Response.End();
            }

        }

     

参考资料

http://www.cnblogs.com/szw/archive/2013/05/14/weixin-course-index.html

http://www.cnblogs.com/iCoffee/p/4815746.html

相关