微信开发介绍+源代码分享

  这两天项目需要在微信上面开一个接口,就研究了一下,过程很艰难,结果很理想,下面我就介绍一下微信开发需要注意的地方。

1,账号问题

  /* 首先说第一个你得选择公众平台(开放平台貌似是做应用集成的,这个没有仔细研究,如果有谁了解,希望告诉我一声),在公众平台我们需要注册账号,账号还分两种,个人类型和企业类型,其中个人类型的只能申请订阅号,而企业类型的才可以搞到服务号,订阅号只能手工或者配置一些关键词去做事情,服务号才能部署一些智能的东东,需要高级开发权限只能是服务号,所以如果你是个人,想要针对用户发过来的消息去回复不同的内容,洗洗睡吧。 */

  搞开发的都知道上面那段话的意思,是的,我给注释了,我今天在登陆订阅号的时候,发现订阅号也有高级功能的,可能我那个时候没有通过审核吧,OK,不妨碍下面的分享。

2,开发模式

  很简单,当你拿到你的服务账号的时候,你会发现,在功能中有个高级功能(在订阅账号里面是没有高级功能这个选项的),之后你可以选择开通哪种方式。目前开发和编辑只能启动一个。

3,配置服务器

  微信接口只有一个URL,任何数据都是通过这个URL和你的服务器进行连接的(GET或者POST)都需要走这个接口,下面会说说两个用到的地方。

4,验证服务器

  在填写你的服务器URL之后,微信会带上几个参数去访问你的URL,你只需要返回特定的数据就OK了,具体方法也可以查看此链接:http://mp.weixin.qq.com/wiki/index.php?title=%E6%8E%A5%E5%85%A5%E6%8C%87%E5%8D%97

  在连接中有部分php的代码可以参考,下面我将我的代码贴一下,在这边我走了很多弯路,所以我尽量贴的全一点

 1         /// <summary>
 2         /// 验证微信签名
 3         /// </summary>
 4         /// <param name="sigNature">微信加密签名,signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。</param>
 5         /// <param name="timestamp">时间戳</param>
 6         /// <param name="nonce">随机数</param>
 7         /// <param name="echoStr">随机字符串</param>
 8         /// <returns>开发者通过检验signature对请求进行校验(下面有校验方式)。若确认此次GET请求来自微信服务器,请原样返回echostr参数内容,则接入生效,成为开发者成功,否则接入失败。</returns>
 9         [System.Web.Http.AcceptVerbs("GET")]
10         [System.Web.Http.ActionName("Api")]
11         [ApiExplorerSettings(IgnoreApi = false)]
12         public HttpResponseMessage CheckSignature(string sigNature, string timestamp, string nonce, string echoStr)
13         {
14             var content =
15                    string.Format("SigNature:{0}\nTimestamp:{1}\nNonce:{2}\nEchoStr:{3}",
16                                  sigNature, timestamp, nonce, echoStr);
17             logger.Debug(content);    // 此处的log你可以删掉
18 
19             var list = new string[] { timestamp, nonce, TOKEN };
20             Array.Sort(list);
21             var tmpArr = string.Join("", list);
22             var tmpStr = FormsAuthentication.HashPasswordForStoringInConfigFile(tmpArr, "SHA1").ToLower();
23 
24             if (tmpStr == sigNature && !string.IsNullOrEmpty(echoStr))     //根据微信的验证规则做判断
25                 return Tools.GetReturn(echoStr);
26 
27             return Tools.GetReturn("error");
28         }

  之所以写了GetReturn这个函数是因为MVC给我的结果封装了,每次我返回一个字符串的时候他都会在外层添加一对引号,微信还傻不愣登的不认识。。。。这个函数主要就是给我去除MVC封装的

1      public static HttpResponseMessage GetReturn(string message)
2         {
3             return new HttpResponseMessage
4                 {
5                     Content = new StringContent(message, Encoding.UTF8, "text/html")
6                 };
7         }

  上面的CheckSignature是一个GET的接口,主要就是验证微信服务的,当然,你仔细研究下微信说的也可以发现,当你收到echoStr的时候,直接return其实就OK了,不必多出验证的步骤。

5,消息接收接口

  我只关注了一个功能,当用户发送消息的时候我要回复用户消息,而且只关注文本消息就OK了(其实别的类型的消息原理都差不多)。

  我们需要注意这边的几点:

  a,此接口的ActionName和上面验证的接口是一样的,这样,他们在外面访问就是相同的URL,只是访问的Method不同罢了。

1         [System.Web.Http.AcceptVerbs("POST")]
2         [System.Web.Http.ActionName("Api")]
3         [ApiExplorerSettings(IgnoreApi = false)]
4         public HttpResponseMessage ReceiveMessage()    

  b,这种获取消息内容的方法我也是研究了好久才找到的,费死劲了。

1   var message = Request.Content.ReadAsStringAsync().Result;

  c,在这个接口他POST过来很多的变量,我都用正则给他搞到了

1             var toUserName = GetItemValue(message, ToUserNameReg);
2             var fromUserName = GetItemValue(message, FromUserNameReg);
3             var createTime = GetItemValue(message, CreateTimeReg);
4             var msgType = GetItemValue(message, MsgTypeReg);
5             var content = GetItemValue(message, ContentReg);
6             var msgId = GetItemValue(message, MsgIdReg);
7             var eventStr = GetItemValue(message, EventReg);
8             var eventKey = GetItemValue(message, EventKeyReg);

  d,我只关注其中两种类型的事件:event and text,event值得是关注和解除关注,在关注的时候要表示感谢不是;发过来的text,我需要找到回复的内容。

            switch (msgType)
            {
                case "text":
                    {
                    }
                case "event":
                    {
                    }
                default:
                    return Tools.GetReturn("error");
            }

  e,全部代码在这里:

1         private static readonly Regex ToUserNameReg = new Regex(@"(?<=<ToUserName><!\[CDATA\[).*?(?=\]\]></ToUserName>)", RegexOptions.Compiled);
2         private static readonly Regex FromUserNameReg = new Regex(@"(?<=<FromUserName><!\[CDATA\[).*?(?=\]\]></FromUserName>)", RegexOptions.Compiled);
3         private static readonly Regex CreateTimeReg = new Regex(@"(?<=<CreateTime>)\d*?(?=</CreateTime>)", RegexOptions.Compiled);
4         private static readonly Regex MsgTypeReg = new Regex(@"(?<=<MsgType><!\[CDATA\[).*?(?=\]\]></MsgType>)", RegexOptions.Compiled);
5         private static readonly Regex ContentReg = new Regex(@"(?<=<Content><!\[CDATA\[).*?(?=\]\]></Content>)", RegexOptions.Compiled);
6         private static readonly Regex MsgIdReg = new Regex(@"(?<=<MsgId>)\d*?(?=</MsgId>)", RegexOptions.Compiled);
7         private static readonly Regex EventReg = new Regex(@"(?<=<Event><!\[CDATA\[).*?(?=\]\]></Event>)", RegexOptions.Compiled);
8         private static readonly Regex EventKeyReg = new Regex(@"(?<=<EventKey><!\[CDATA\[).*?(?=\]\]></EventKey>)", RegexOptions.Compiled);
 1      /// <summary>
 2         /// 接受微信消息,如果需要反馈,则调用回复接口进行答复
 3         /// </summary>
 4         /// <param name="ToUserName">开发者微信号</param>
 5         /// <param name="FromUserName">发送方帐号(一个OpenID)</param>
 6         /// <param name="CreateTime">消息创建时间 (整型)</param>
 7         /// <param name="MsgType">text</param>
 8         /// <param name="Content">文本消息内容</param>
 9         /// <param name="MsgId">消息id,64位整型</param>
10         /// <returns>successful or not</returns>
11         [System.Web.Http.AcceptVerbs("POST")]
12         [System.Web.Http.ActionName("Api")]
13         [ApiExplorerSettings(IgnoreApi = false)]
14         public HttpResponseMessage ReceiveMessage()
15         {
16             var message = Request.Content.ReadAsStringAsync().Result;
17 
18             var toUserName = GetItemValue(message, ToUserNameReg);
19             var fromUserName = GetItemValue(message, FromUserNameReg);
20             var createTime = GetItemValue(message, CreateTimeReg);
21             var msgType = GetItemValue(message, MsgTypeReg);
22             var content = GetItemValue(message, ContentReg);
23             var msgId = GetItemValue(message, MsgIdReg);
24             var eventStr = GetItemValue(message, EventReg);
25             var eventKey = GetItemValue(message, EventKeyReg);
26 
27             var logStr = string.Format("Message:{8}\n\nToUserName:{0}\nFromUserName:{1}\nCreateTime:{2}\nMsgType:{3}\nContent:{4}\nMsgId:{5}\nEvent:{6}\nEventKey:{7}",
28                         toUserName, fromUserName, createTime, msgType, content, msgId, eventStr, eventKey, message);
29             logger.Debug(logStr);
30 
31             switch (msgType)
32             {
33                 case "text":
34                     {
35                         var returnMessage = Tools.GetCategory(content);  // 这块是获取反馈信息的方法,你的和我的应该不一样,所以这块你得修改一下。
36                         var sendMessage = GetSendMessage(fromUserName, returnMessage, toUserName);
37                         logger.Debug("MsgId:" + msgId + Environment.NewLine + sendMessage);
38 
39                         return Tools.GetReturn(sendMessage);        // 这个函数在上面已经贴出来了,在这块就不在贴了
40                     }
41                 case "event":
42                     {
43                         if (eventStr == "subscribe")      // 关注事件
44                         {
45                             var returnMessage = "欢迎关注**账号 [微笑]";
46                             var sendMessage = GetSendMessage(fromUserName, returnMessage, toUserName);
47                             return Tools.GetReturn(sendMessage);
48                         }
49                         return Tools.GetReturn("error");
50                     }
51                 default:
52                     return Tools.GetReturn("error");
53             }
54         }
 1      /// <summary>
 2         /// 获取消息体中正则所能匹配到的内容
 3         /// </summary>
 4         /// <param name="message">消息内容</param>
 5         /// <param name="regex">正则</param>
 6         /// <returns>返回正则匹配的所有内容</returns>
 7         [ApiExplorerSettings(IgnoreApi = true)]
 8         private string GetItemValue(string message, Regex regex)
 9         {
10             if(regex.IsMatch(message))
11                 return regex.Match(message).Value;
12             return "";
13         }
 1 /// <summary>
 2         /// 发送被动响应消息
 3         /// </summary>
 4         /// <param name="ToUserName">接收方帐号(收到的OpenID)</param>
 5         /// <param name="Content">回复的消息内容(换行:在content中能够换行,微信客户端就支持换行显示)</param>
 6         /// <param name="FromUserName">开发者微信号</param>
 7         /// <param name="CreateTime">消息创建时间 (整型)</param>
 8         /// <param name="MsgType">text</param>
 9         /// <returns></returns>
10         [System.Web.Http.AcceptVerbs("POST")]
11         [System.Web.Http.ActionName("GetSendMessage")]
12         [ApiExplorerSettings(IgnoreApi = false)]
13         public string GetSendMessage(string ToUserName, string Content, string FromUserName = Developer,
14                                      string MsgType = "text")
15         {
16             var createTime = Tools.ConvertDateTimeToInt(DateTime.Now);
17 
18             return
19                 string.Format(@"<xml><ToUserName><![CDATA[{0}]]></ToUserName><FromUserName><![CDATA[{1}]]></FromUserName><CreateTime>{2}</CreateTime><MsgType><![CDATA[{3}]]></MsgType><Content><![CDATA[{4}]]></Content></xml>", ToUserName, FromUserName, createTime, MsgType, Content);
20         }

 

    现在能想到的地方就是这些了,如果有什么问题欢迎留言。

    记在这里,以后学习。

 

posted @ 2014-04-22 15:23 pmars 阅读(...) 评论(...) 编辑 收藏